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Alpha Logic Business Systems, Inc. reserves the right to make improvements 
in the product described in this manual at any time and without notice. 

Alpha Logic Business Systems, Inc. and the authors make no warranties, 
either express or implied, with respect to this manual or with respect to 
the so-ftware described in this manual, its quality, performance, 
merchantability, or -fitness for any particular purpose. This software is 
sold or licensed "as is". The entire risk as to its quality and 
performance is with the buyer. Should the programs prove defective 
following their purchase, the buyer (and not Alpha Logic, the author, 
their distributors, or their retailers) assumes the entire cost of all 
necessary servicing, repair, or correction and any incidental or 
consequential damages. In no event will Alpha Logic or the author be 
liable for direct, indirect, incidental, or consequential damages 
resulting from any defect in the software, even if they have been advised 
of the possibility of such damages. Some states do not allow the 
exclusion or limitation of implied warranties or liability for incidental 
or consequential damages, so the above limitation or exclusion may not 
apply to you. 

MOT ICE Of=^ COF^YR I GMT 

This manual is copyrighted. All rights are reserved. This document may 
not, in whole or in part, be copied, photocopied, reproduced, translated 
or reduced to any electronic medium or machine readable form without prior 
consent, in writing, from Alpha Logic Business Systems, Inc. 

This software is a fully copyrighted work and as such is protected under 
the copyright laws of the United States of America. According to these 
laws, consumers of copywritten material may make copies for their personal 
use only. Duplication for any other purposes whatsoever would constitute 
infringement of copyright. 

Copyright 1980-19S7 by: 
Alpha Logic Buiinett Syttemt, Inc. 
163 Oilctgo Street 
Gary. lUinois 60013 

The word LOCKSMITH and the Locksmith logo are registered trademarks of 
Progressive Business Systems, Inc. 

m«rdw#=»re: REcau I retmemts 

Apple II, Apple II Plus, Apple //e, Apple //c, or compatible computer. 
48K required. One or two disk drives. 

Optional hardware supported: 16K, 32K, 64K, 128K, 256K slot RAM boards or 
auxiliary memory boards) optional printer. 

Lorksmith 6.0 - manual revision: 6.0.00 
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IlNlT-FtOOLJCT'IOlNl 

THE COPYRIGHT LAW ALLOWS THE CREATION OF ARCHIVAL COPIES OF COMPUTER 
SOFTWARE WHICH IS OWNED BY THE LOCKSMITH USER. LOCKSMITH IS SOLD WITH THE 
UNDERSTANDING THAT THE PURCHASER WILL NOT USE THE PROGRAM TO GENERATE 
DISKS OF COPYRIGHTED PROGRAMS FOR SALE OR DISTRIBUTION. 



^^^BOLJT- YOUR IslETUI LOOKSMI-TM <£> _ O 

Locksmith was first released in December, 1980. It was the -first bit-copy 
(or ni bb 1 e-copy ) program aval I able for the Apple. Since that ti me. 
Locksmith has evolved from a bit-copy program into a powerful disk and 
memory utility. 

While other bit-copiers made minor enhancements and charged update fees 
for the "new" software, Locksmi th users have been abl e to install 
enhancements to their own copies of Locksmith by applying patches which 
are suppl led free of charge. 

As new enhancements to Locksmi th become avai 1 abl e in the form of updates, 
user appl i ed patches, and new parameter disks, regi stered users are 
not i f i ed by mai 1 or the Locksmi th newsl etter . If you have not a I ready 
done so, be sure to complete the registration card included with your 
Locksmi th . 

Locksmith programming language (LPL) has been greatly improved. Many 
users found the LPL section in the version 5.0 manual to be difficult to 
read. A large part of this manual is dedicated to explaining the details 
of LPL , usi ng many ex ampl es. Whi le a great deal of effort has been trade 
to keep LPL i n versi on 6.0 compat ible with LPL i n versi on 5. 0, the code 
1 1 sel f has been compl etel y rewr 1 1 ten , and 1 anguage def i ni t i ons have been 
extended to allow for easy future expansion. Almost all Locksmith 
f unc t i ons can now be i nvoked from LPL (includi ng Fast Disk Backup and 
sector edi ting) . 

The Locksmith philosophy has always been to allow the user to backup his 
software, but not to promote software piracy in any way. Locksmith always 
made an i dent i cal copy of the or i gi nal di skette, i ncl udi ng 

copy-protect i on , copyr i ght not i ces, and ser i al numbers. The copy made by 
Locksmith was, like the original diskette, copy-protected. New protection 
techniques were i ntroduced and Loc ksmi th handl ed them. However , recent 1 y 
some manufacturers have introduced copy protection techniques which ar& 
based on the fact that special hardware can create a special "signature" 
whi ch can be read by a standard Appl e disk dr i ve, but not rewr i tten. 
Because of the introduction of these truly uncopyable diskettes, we have 
found i t necessary to all ow the user to "unprotect " or "break " the 
software in order to make a backup . 1 1 i s i mport ant to understand that by 
provi di ng tool -5 to all ow the user to remove the copy protect i on , that we 
in no way condone or promote software piracy. We will not knowingly 
accept or publish parameters whi ch remove copyri ght not i ces, serial 
numbers, or other i dent i f yi ng i nf ormat i on along with the copy protect i on. 
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Locksmith 6.0 has many completely new functions, includings 

Automat i c Boot Tr acer 

Sector and Track Edi tor 

Sector Editor ^or Protected diskettes 

RAM Card Utilities including RAMtest. 

Advanced Disk Recovery: 

Data written off-center 

Data Mr i tten on mi sal i gned dr i ve 

Partially overwritten sectors 

DOS Fi le Util ities: 

Alphabetize CATALOG 

Un-Delete a file 

Remove DOS from diskette 

Fix sector counts 

Ver 1 f y VTOC and fix errors 

Disk space map 

File Edi tor 

Encrypt/Decrypt a file 

Your Locksmith 6.0 disk and the included parameter diskette (parmdisk) are 
not copy-protected . You shoul d i mmedi at el y make a bac kup copy of your 
original diskettes using the FAST DISK BACKUP function of the mam menu 
and place the originals in a safe place. You may need the original 
Locksmi th diskette for program updates ^ as they Are made avail ab 1 e. 
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-THE H I STORV OF^ LOCKSMI TM 

For the past several years, there has been an intense battle being fought 
between so-ftware manufacturers and software users. The manufacturers, 
concerned about their programs being pirated or stolen* started 
'protecting' their software. They did this by making their programs 
uncopyable. This means that normal copy programs would no longer copy 
their software. Since it could not be copied, it could not be passed 
around between users. This was to insure that anyone who wished to use a 
program would be required to purchase it, thereby guaranteeing that the 
manufacturer would receive his fair share of profits. 

As in most issues, however, there are two sides. Software users, upon 
purchasing a program, received a disk which they could not copy. This 
means that they could not even make back-ups of their disks, which is a 
legitimate concern of everyone who has 'blown' a disk. Since some 
businesses day to day operations rely very heavily on their software 
investment , this becomes a very critical situation. Some applications 
simply do not allow for up to several weeks waiting time while the bad 
disk IS sent out to be replaced. In addition, some of the manufacturers 
charge inflated prices to get these replacements. It seems rather unfair 
to charge ♦35.00 for a replacement of a »2.00 disk for which the user 
already paid ♦250.00 to purchase. 

Short 1 y after these 'protected' disks started appearing on the market, 
Locksmi th was made avai 1 abl e to copy these disks. Locksmi th used a new 
type of technology to copy protected software, known as nibble-copying. 
In the several years since, the manufacturers have i ntroduced new, more 
sophisticated methods of copy protection. As a result. Locksmith has been 
updated several times to anticipate new methods of protection. 

In this section, we will discuss the origin of Locksmith, and some of the 
different methods that have been used for protection over the past several 
years. 

The original Locksmith program was written in 1979 by An Apple programmer 
with IB years of computer experience, including systems programming on 
large IBM mainframes at several large corporations. His interest in 
computers dates back to grammar school, when he would spend his Saturdays 
taking computer courses at the 1 1 T computat i on center in Chi cago. 

The first version of Locksmith, which was never released, was a primitive 
ni bbl e copy program known as 'NIBY'. It was wr 1 tten as an educat i onal 
e>;cer c i se — "because 1 1 was a chal 1 enge" . When i t was shown to some of 
his 1 1 ose f r i ends from the 1 ocal Appl e users group , i t gathered much 
interest, and because no program like it was avai 1 abl e, several Appl e 
users suggested that the program might be marketable. 

In December 1980, Locksmith version 2.0 was released. It was the first 
program ever introduced to allow the Apple user to backup his 
copy-protected software. 

Like any tool in the wrong hands, it wa« feared that Locksmith might be 
used for tasl<s it was not intended to perform — PIRATING. Because of 
this fear , each Locksmi th was uni quel y ser i al numbered and regi stered, and 
every copy of Locksmith also placed this unique serial number on EVERY 
disk that it copied. This fact, by the way, was never made known until 
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Encoding the Locksmith serial number on the copied disk provided the 
distributor with the capability ai identifying the owner o-f any Locksmith 
used -for pirating any manufacturers software, and the distributor offered 
to assist software manufacturers in the prosecution of software pirates. 
No software manufacturer however, has ever requested this assistance. 
Placing the Locksmith serial number in an inconspicuous place on every 
disk that is copi ed i s not an easy task. In f act , this practice has 
caused several probl ems with copyi ng some disks in ear ly < versi on A ) 
rel eases of Locksmi th . Because of this, Locksmi th, begi nni ng with versi on 
5.0 no longer encoded its serial number on the copy disk. 

Locksmith has evolved from version 1.0 (the unreleased 'NIBY'), to 
versions 2.0, 2.1, 2.2, 3.0, 3.1, 4.0, 4.1, 4.1a, 5.0, 5.1, and now 6.0. 
No longer the work of a single programmer. Locksmith 6.0 is now maintained 
by a team of Appl e copy-protect i on experts. 

No longer just a nibbl e~copi er , Locksmith is now a f ul 1 -f eat ured utility 
and diagnostic tool for the Apple II computer. Always searching for 
improvements, Alpha Logic welcomes suggestions, comments, and any 
questions you may have about Locksmith. 

Me will now di scuss some of the di f f erent methods that have been used for 
protect 1 on over the past several years. Some of the descripti ons are of a 
technical nature, and Are intended for the more advanced user. 

The very first types of copy protect i on to appear were very si mpl e in 
nature. The first protected disks used nothing more complicated than 
erasing an unused track on the disk. This was usually track 3. This 
method is not very complicated, but initially it was quite effective. All 
of the copy programs at that time copied the disk one track at a time. 
When it tried to read the erased track, it would get an I/O error, causing 
the copy program to stop. By doing this, none of the tracks beyond the 
erased track would copy. 

Borne of the copy programs that came out a little later would copy only 
those sectors that were marked on the catalog track (track *11) as being 
used. This got past the erased track problem. To combat those copy 
programs, companies started to move the catalog to a different track. 
When the copy program went out to track til to read the information, the 
information would not be there. This also prevented a normal Disk 
Operating System (DOS) from reading and writing to the protected dis^. 

Shortly after that time, a new method was introduced. It was a little 
t-nown fact that while the disk normally used only tracks ♦00-»22, it was 
actually capable of reaching track »23. Some of the software began using 
this track for program information. All copy programs at that time were 
incapable of copying track »23, so that when a copy was made, some 
information was lost. This method proved to be very dangerous, because 
some disk drives could not reliably read or write to track ♦23. This 
means that you could not even use the original protected disk on that 
drive, since it could not read that track. 

At this point, the protection methods started to become more 
sophisticated. State of the art had progressed to the point where the 
manufacturers were actually changing the format of information on a disk. 
At first, this was done by changing the checksum for the address field on 
the disk. This would cause I/O errors which would halt the copy process. 
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Disks which were protected by changing the format of information required 

their own Disk Oper at i ng System. 

At approximately the same time, some manufacturers started changing the 
format of the address field on a disk sector. Normally, the format is to 
have an address header, foil owed by i n for mat i on concern i ng the vol ume, 
track, sector and checksum. This was followed by an address trailer. The 
order of the volume, track and sector was changed around, or put in a 
di f f erent f or mat . For ex ampl e, one company changed all sector numbers to 
be even numbers. Instead of sectors O, 1, 2, 3 etc., they used numbers of 
O, 2, 4, 6 etc. Normal DOS could not understand these formats. 

The headers and trailers for both the address fields and data fields were 
changed as the next type of protection. Since DOS looks for a specific 
header or trailer to read a sector, it will never find a sector on this 
t ype of disk. On these disks, it woul d i mpossi ble to read any 
i n for mat i on wi th a normal DOS. 

Once again, an entirely new technology appeared for protection. Up until 
this time, all information was stored on a disk in Track/Sector format. 
Now, tracks started to appear usi ng pseudo-sectors. A pseudo-sector i s a 
1 ong string of data, with onl y a data header of some type. Some of these 
pseudo-sectors were an entire track in length. None of the programs for 
reading Tracl- /Sector format coul d decode this type of track. With the 
advent of pseudo-sector s, nibble copy programs became necessary . Unt i 1 
this t i me, it was usual ly possible to modi f y normal DOS, to copy these 
disks. This was no 1 onger possi ble. Shortly af ter pseudo-sectors 
appeared, Locksmi th was f i rst i nt reduced. It was capabl e of copyi ng 
tr ac ks which were in a non-standard format . 

Synchronized tracks were the next method of disk protection. Synchronized 
tracks are tracks that are written in a specific timing relationship to 
each other. For example, after reading track *00, the disk drive would 
then seek to track ♦01. Upon ar riving at track *01, data woul d be read i n 
f rom that track. The program that was boot i ng woul d 1 ook for spec i f i c 
data to be present when it arrived at the new track. If this data was not 
at the beginning of the track it read, it would cause the program to fail. 
This meant that copying tracks without preserving this timing relationship 
would result in a bad copy, even though all of the information was 
transfer ed . 

Another type of protect i on whi ch was concerned not onl y with the actual 
data that was copied, was nibble counting. After writing a track when 
generating a disk, the track would be read back, and a count of the 
ni bbl es on a track woul d be stored on the disk. Upon boot i ng, the disk 
would look for the track to be that specific length. Since very few disk 
drives run at exactly the same speed, the chances were very unlikely that 
the track 1 ength woul d be the same on a copi ed disk. 

Software manufacturers next started to take advantage of a little known 
fact concerning the disk drive. While disk drives were normally used on 
tracks *00 through #22, they wer» capabl* of reaching b«tw«»n trackm. 
This araa between tracks is known as a half-track. Due to the width of 
the read/wr i te head, it is not possi ble to wr i te data on adjacent tracks 
and half tracks wi thout ex peri enci ng cross-tal k probl ems. However , it is 
passible to wr i te data on hal f -tracks, providing that the adjacent tracks 
Are not used. It then became necessary to use copy programs that were 
capable of reaching these half-tracks. One major problem with this type 
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of protection scheme is that not all disk drives are capable of reaching 
half-tracks. Some very popular drives can only reach integral tracks, and 
disks using this type oi protection can not boot on these drives. H you 
*re using Micro-sci typs A40 drives with your Apple, keep in mind that 
half-tracks can not be accessed, although all other Locksmith functions 
work as documented. 

There was one type of protecti on whi ch appeared and shortly thereaf ter , 
di sapp eared from the market, Thi s t ype of protecti on actually physically 
damaged the disk. A scratch was made on the disk w\*.h a sharp instrument. 
When booting, the disk would attempt to write and then re-read data on the 
track with the scratch. If the test passed, it meant that the disk was 
not damaged, and therefore, not an ori ginal disk. This was a very 
undesi reabl e method, since the damaged port i on of the disk woul d need to 
come in contact with the read/write head on the disk drive. When the head 
was over the damaged track, you could actually hear a 'tick-tick' as the 
scratch hit the head- This could cause damage to the head, and because of 
that, the method was quickly abandoned. 

The chief difficulty in copying protected disks was identifying which 
ni bbl es on a track were normal , and whi ch ni bbl es were self-sync. 
Locksmith versions 2, 3, and 4 attempted to identify self-sync nibbles by 
context, that is by the surrounding nibble patterns. Up until this time, 
disks used nibbles with a value of *FF for self-sync nibbles. It was a 
fair as sump t i on that a string of »FF nibbl es represented fields of 
sel f -sync . To combat this, manuf acturers started to use different values 
for self-sync. Thi s made i dent ifying self -sync ni bbl es more difficult. 
In some cases, multiple nibbles were used, for example tDS »AB »D5 »AB, 
etc , Bee ause Locksmi th identifi ed sel f-sync nibbl es contex tual 1 y , 
parameter changes were requi red for copyi ng disks of this type with 
Locksmith versions 4.1 and earlier. 

One very sophi st i cated method of protect i on appeared on the market short I y 
thereafter. This method required that specific nibbles in the middle of 
normal data be special self-sync nibbles. By using timing routines, it 
was possible to deter mine if this nibble was normal , or spec i al . Thi s 
special nibble is call ed a data-1 atched ni bbl e. When reading a track of 
nibbles normally, the data-latched nibble was indistinguishable from a 
normal nibble. Copyi ng these tracks was very difficult, since it requi red 
actually breaking or deciphering the code to determine which nibbles had 
to be data-1 atched . Th i s method was -very effective, and has been i n use 
fur quite a whi 1 e. Locksmi th 5,0 was capabl e of deter mi ning self-sync 
nibbles while reading them without regard to context nibbles, and it was 
able to detect data-latched nibbles without any user-supplied parameters. 

As mentioned before, it is not possible to write adjacent tracks and 
half-tracks. This is due to the fact that the read/write head is wide 
enough to over 1 ap onto the adjacent track or hal f -track , ef f ect i vel y 
erasing information. To alleviate this problem, the concept of spiral 
tracks was invented- This is simply writing approximately 1/3 of a track. 
Jump out a half track, write another 1/3 of a track, etc. By using this 
method, adjacent tracks and half-tracks may be used without actually 
wri t ing any data closer than one full track apart. The data on the disk 
actually seems to spiral in toward the center of the disk, hence the name 
' sp i r al track ' . 

The most recent type of protection is much the same as half-tracks. It is 
the use of quarter tracks. While it is true that the disk drive is not 
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normally capable of reaching quarter tracks, it is passible to drive the 
stepper mot or on the dr i ve so that it will st op on the quarter track . 
Thi != requi res some very spec lal timing rout i nes. It works basically the 
same as hal -f -tr ac k s, and the same restrictions about adjacent data apply. 

Locksmith 6.0 is capable of handling all of these types of protection 
methods, along with many others. Due to its extreme flexibility, it will 
also support many protection methods which have not yet appeared. 

I f , whi 1 e usi ng Locksmi th , you find a parti cul ar 1 y useful suggest ion or 
technique that you would like to see included in a future release of 
Lock smith, please 1 et us know. 
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COMMOIM LOCKSMITH COIMTROU. KEVS 

Thr>* kaystrok*s listad In tha Lockamlth main oianLi can ba typad at any 
tima, whathar In tha nain nanu or not. Thaaa kays ara Ccontrol-Z3, CESCl, 
and tha CRESET] kay. 

Ccontrol-Z3 

Praaslng 'CTRL-Z' at any tima will print tha taxt acraan to a prlntar. 
Tha prlntar ahould ba turnad on and anablad. Lockamlth aasumaa that tha 
prlntar intarfaca la inatalled in Slot 1, but may be changad to any alot 
by changing tha paramatar nama 'PRT.SLOT'. 

CESC: 

Tha ESC kay may ba prasaad at any tima to abort a function, and placa you 
in an aarliar manu. Praaaing thia kay Mill avantually bring you back to 
tha Locksmith main manu. 

C RESET] 

To ax it Lockamith and ra-boot your ayatam, praaa tha RESET kay whila 
holding down the CTRL kay. 

IMF»ORTAMT- l_OCKSr-IITM I InIFORM^T I OM 

Whan the prompt 'PRESS SPACE TO CONTINUE' appears in flashing characters 
at tha bottom of the acraan, you may press tha apace bar to continue, or 
press the ESC key to abort tha function. 

The entire Locksmith program is too large to fit In the memory of your 
Apple at one time. It la loaded from disk into memory In sections called 
"overlays". It Is important to keep your Locksmith disk in the boot drive 
until Instructed to insert other disks to process. If an overlay is 
required to ba loaded, and tha Locksmith diskette is not Inserted, you 
will be prompted to re-insert tha Locksmith disk. 

When a Locksmith function Is invoked which requires you to insert 
diskettes either for input or output, you will be prompted to insert them 
before the function begins processing.' Signal that the diskettes have 
been inserted by pressing the space bar. If at any time you wish to 
cancel or abort a function, press the ESC key. 



THE TR#=»C:K ST#^TLIS DISF^L-ftV 

The top 7 lines of the Locksmith acreen ara reaerved for the track atatua 
di apl ay. 

This display shows tha status of the last operation on each track of the 
dlakette. Tracks are numbered from 00 to 22 (in hexadecimal, which is 
to 34 in decimal). A position for track 23 is provided because some early 
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protection techniques made use of this accessable but normally unused 
t rac y . 

Although most Apple software only uses integer tracks from 00 to 22, the 
Apple dlst drive is actually capable of moving the head between tracks. 
For this reason, four lines are provided for each numbered track. The 
topmost of these four lines contains the status codes for integer track 
numbers such as 00, 01, 02, etc. The other 3 of the 4 lines contain track 
status codes for 1/4 tracks, half-tracks, and 3/4 tracks, respectively. 

Shown below is An example track status display. 

THE LOCKSMITH - VERSION 6.0 - REVISION A 

.00 o 

.25 

.50 4 

.75 5 

HE X OOOOOOOOOOOOOOOO 1 1 1 1 11 1 U 1 1 1 1 1 1 1 2222 

TRK O 1 23456789ABCDEF0 1 23456789ABCDEF0 1 23 



The example shows status code O for track OA, status code 4 for track 
13.5, and status code 5 for track IB. 75, 

Status codes Are dependent on the individual Locksmith function currently 
running, and Are described separately. 
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B^CK I IMC3 UF^ ^ D I SK 

There are several functions within Locksmith which are capable of bacMng 
up a diskette. Which one you will want to use depends on the diskette you 
wish to copy. 

li the diskette is not copy-protected, use the FAST DISK BACKUP function 
by pressing 'F' from the main menu. 

If the diskette is copy-protected, use the TEXT EDITOR Backup function 
<'T' from the main menu, 'B' from the text editor menu) and determine if 
the name of the program is in the list of suppl i ed parameters on the 
parameter diskette <incl uded with Locksmi th > . If t^.e name i s found, 
select the name and the backup operation will begin c±utomat ical 1 y. 

If the name is not found on the parameter diskette. Try using the standard 
copy routines by selecting BACKUP/COPY (key 'BM from the main menu. Most 
protected software can be copi ed using the standard back up /copy f unct i on. 

If you used parameters on the parameter diskette to back up your disk, but 
are still unabl e to successful ly backup your disk, it is possible that a 
di f f erent prot ec 1 1 on techni que is bei ng used for that particul ar pi ece of 
software. Software compani es frequent 1 y change protect i on techniques to 
make it as conf usi ng as possi bl e for those trying to copy the sof tware. 
Call or write our customer support group to find out if new parameters are 
available for your particular software. 

Finally, if you are techni cally experi enced and enjoy chal 1 enges , you 
might consider developing parameters to copy the software yourself. 
Locksmith has many useful tool s to help you deter mine the type of 
copy-protection and help you either copy the software or disable the 
protect I on. 
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THE l_OCH:;SM I TM M«=^ I tM MEISILI 

Immediately a-fter booting your Locksmith disk, the main menu appears. 

THE LOCKSMITH - VERSION 6.0 - REVISION A 

.00 

.25 

.50 

.75 

HE X 0000000000000000 1 1 1 1 1 1 U 1 1 1 1 1 1 1 1 0000 

TRK 1 234567B<?ABCDEF0t 234567e9ABCDEF0 1 23 

B BACKUP/COPY F FAST BACKUP / CLR STATUS 

N DISK EDITOR L LOAD RAM CD * PARAMETERS 

T TEXT EDITOR R RAMCD UTILS Q SCAN DISK 

A BOOT TRACER C CERTIFY DSK U 16-S UTILS 

D D0S3.3 UTIL X DSK RECOVER S DISK SPEED 

E ERASE DISK 

I INSPECTOR 

CTRL-Z PRT SC RESET EXIT LS ESC RESTART 

The top 7 lines o-f the display are the track status display. 

The body of the main menu displays the keystrokes <in inverse) which you 
may enter at this time and a brief description of what function each key 
performs. The functions available in the main menu are each discussed 
separately in this manual. Briefly they Are: 

CB: BACKUP/COPY - This function allows you to backup protected software 
using the Locksmith standard copy routines, which will backup most 
protected software without parameters. 

CF3 FAST BACKUP - The Fast Backup function allows you to quickly create 
backup copies of any unprotected software. Depending on the amount of 
memory in your system, this utility can backup a disk in as little as 8 
seconds ' 

C/] CLR STATUS - Pressing the "/" key will clear the track status display 
at the top of the screen. 

CN] DISK EDITOR - The Disk Editor (formerly the Nibble Editor in earlier 
releases of Locl.smith) can be used to manually read, search, change, and 
rewrite data, either in sector format or nibble format. In addition, the 
Disl Editor is used to edit DOS and PRODOS files, and can be used to edit 
data on any RAM cards installed in the Apple. 

CL] LOAD RAM CD - This function will load a slot O RAM card on an Apple II 
or Apple II Plus, or load the built-in 16K RAM on an Apple //e or Apple 
//c. This function loads 1 2K of data which is found on tracks 12, 13, and 
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14 <heN) oi the Locksmi th disk. If you own Inspector and Wat son , you can 
wr 1 te them to these traces, and they will be 1 oaded whenever you sel ec t 
this function. Once loaded. Inspector and Watson are available by 
press i ng the 'I' key from the mai n menu. 

C*] PARAMETERS - This function allows you to display or change the current 
Locksmith operating parameters by name. For a complete list of all of the 
Locksmith parameter names, please refer to the Locksm th Technical 
Reference Manual. 

CT3 TEXT EDITOR - The Locksmith Text Editor is used to edit files 
containing Locksmith Programming Language <LPL>, which can be loaded and 
saved to your Locksmith parameter disk. The BACKUP function of the text 
editor will allow you to automatically backup protected software after 
speci fying the name of the software. 

CR3 RAMCD UTILS - The Locksmith RAM card utilities can be used to test RAM 
cards in the Apple. RAM cards of any size can be tested, and two tests 
<ire provi ded: a basic test and an ex ten si ve test. The test can be 
performed once or continuously to help isolate intermittent errors. In 
addition, the contents of any 16K bank of the RAM card can be dumped into 
main memory, edited with the disk editor, and re-loaded to the RAM card. 

CD] SCAN DISK - Formerly known as "quick scan" in earlier versions of 
Loc^smith, this utility allows you to examine on the hi-res graphics 
screen an overall "picture" of the diskette, track by track. This 
f unct 1 on is useful in determining how each track of ah unknown disk is 
formatted. 

CA] BOOT TRACER - The Automatic Boot Jracer is intended for use by the 
more e;;perienced Apple programmer. It is actually a sophisticated 
debugger which can simulate the operation of the A502 in the Apple. 
Because disk reading is simulated, it is possible to actually "boot" a 
disk (whether protected or not) under control of this debugger and trace 
the boot code of the program. 

CC] CERTIFY DSK ~ The Certify Di sk function will write a special pattern 
to each trac^ of the diskette and immediately re^d it bad to make sure 
that no scratches or other imperfections on the diskette surface will 
affect the reading and writing of data to the diskette. 

CD] 16-S UTILS - This menu option will bring up a secondary menu 
containing useful 16-sector utilities. These utilities can be used to 
verify a diskette, compare two diskettes, format a dlsi^ette, or display 
the "sync signature" of a diskette. 

tD] 0053."!: UTIL - This menu option will bring up a secondary menu 
containing useful DOS 3.3 utilities. These utilities can be used to 
alphabetize a catalog, undelete a file, load a DOS file into memory for 
examination by the Disk Editor, show a disk free space map, f i >; incorrect 
sector counts in the catalog, identify and correct catalog/VTOC errors, 
and remove DOS from a disk to allow for the storage of more files. 

CXI DSK RECOVER - The Advanced Disk Recovery utility will read a difficult 
or impossible to read diskette and write a good copy to another diskette. 
This is especially useful for recovering data from diskettes which were 
written in drives which were al igned improper 1 y . Advanced Di sk Recovery 
will actually recover data from a diskette which was written while 
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inserted in the disk drive of-f-center' 

CS] DISK SPEED - This utility will allow you to check the speed of your 
disk drives so that you may adjust the speed to the standard 300 R.P.M., a 
recommended speed which is slightly slower, or set the speed of the drive 
to the same speed that created a gi ven diskette. 

CE3 ERASE DISK - This function is used to entirely or partially erase a 
di sket te. 

CI] INSPECTOR ~ Invokes Inspector and Watson if the utility programs are 
available or have been previously loaded with the 'L* menu item, 

tESC3 RESTART - At any time during the operation of Locksmith the 'ESC 
key may be pressed to abort the current f unct i on and return to the 
previ ous menu or mai n menu. 

CCTRL-Z3 PRT SC - To print the contents of the text screen to the printer 
at any time during the operation of Locksmith you should hold down the 
' CTRL' key and press 'Z'. 

CRESET] EXIT LS - To exit Locksmith hold down the 'CTRL' key and press the 
' RESET ' key. This will cause an i mmedi ate reboot . 
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&^Ch^.Uf=^ y COF^Y DISK 

CBD BACKUP/COPY 

Pressi ng ' B' from the mai n Locksmi th menu will all ow you to make a bac^ up 
copy of most protected software. If the disk you wit.h to backup is not 
protected, you will want to use the much faster FAST BACKUP utility (key 
' F' from the mai n menu ) . 

The 'B' (backup/copy) function uses the standard copy routines, which work 
well for most protected software. To use copy routines which are already 
tailored for a specific protected diskette, use the 'iiain menu ' T' <te;<t 
editor) function to select the name of the program you wish to back up. 
See the tex t-edi tor sec 1 1 on of this manual for mor e i n format i on. 

After pressing 'B' from the main menu, you are prompted for input and 
output drives. If you spec i f y the same dr i ve for both (if you have onl y 
one dr I ve) , you will need to swap di s^'s for each track to be cop i ed . You 
Ar& then prompted for the range of tracks for the copy operation and the 
track increment. To use the default values displayed for track start, 
tracti end, and trac^ increment, you may simply press the RETURN ^ey. 
After specifying whether the tracks should be synchronized and whether the 
track 1 ength shoul d be preserved (a technique known as "nibble count i ng" ) , 
you will be prompted to i nsert the diskettes for the copy operat i on, and 
the bact>up will begin. 

The track status display at the top of the screen will contain the status 
codes for each track copied. A zero indicates that the track copied with 
no errors. Other codes indicate errors whi ch have occurred whi 1 e copy i ng 
the track. Since the status codes Ar& dependent on the LPL (Locksmith 
Programmi ng Language > being executed, refer to the individual LPL file for 
a descripti on of status codes and error messages. 



Locksmith 6.0 Page 14 



CF] FAST DISK BACKUP 

Pressing T' from the Locksmith main menu will enter the Fast Disk Backup 
utility. Fast Disk Backup (FDB) is intended to be used to backup 
unprotected di sket tes. 

FDB is very fast. It reads a disk in as little as 8 seconds, and writes a 
disk in about the same amount of time. Optionally verifying the written 
data by reading it back and comparing it requires another 8 seconds, if 
it's desi red. 

Locl<smith FAST DISK BACKUP is the FASTEST Apple copy program with or 
without the use o-f RAM boards. 

Locksmi t h 6.0 FDB can automat i cal 1 y swi tch between two dr i ves and wri te 
disks from memory, producing a new disk every 8 seconds. This is very 
useful for mass -product i on of software for clubs or software 

manuf acturer s. 

FDB will automatically recogniie any RAM cards in your Apple, whether they 
are in slots 0-7 or in the au>;iliary slot of the Appl e //e. The au:<i 1 lary 
64K present on the Appl e //c is also used. Both the Appl e / /e and Appl e 
//c have a built-in 16K RAM which appears as slot 0. RAM boards from 
several manufacturers, including Checkmate Technology, Applied 
Engi neer 1 ng , and Ti tan Technol ogy have been tested with Locksmith 6.0 and 
worl- well. Locksmith FDB will recognize 16K, 32K, 64K, 128K, and r56K RAM 
cards. To copy an ent ire disl into memory requi res 1 401' ( 4K per track) . 
FDB uses 40K of main memory for track storage, and therefore needs 1 OOK in 
RAM cards to make one-pass copi es or copi es ent i rely from memory. All 
slots, including slot 3, are searched for RAM cards. 

F^^iis^t D i ^ l< Bsn=l<Lji(i> Cc3nr>m^kn d ^ 

Si mp le commands Are entered from the keyboard. After pressing the return 
ley, the current command can be seen in the current command display area 
in the 1 Dwer left of the screen. The def aul t command is "12", which means 
to copy drive 1 to drive 2. 

A complete list of commands: 

1 2 copy drive 1 to dri ve 2 

21 copy drive 2 to dri ve 1 
11 copy drive 1 to drive 1 

22 copy drive 2 to drive 2 

1 read verify drive 1 

2 read ver ify drive 2 

lO copy drive 1 into memory 

20 copy drive 2 into memory 

01 copy memory to drive 1 

02 copy memory to drive 2 

V turn veri f y~af ter-wr i te flag on or off 

Cspace] or. Creturnl begins the copy or verify operation 

C reset 1 exi ts Fast Di sk Backup 

Ccontrol-Z] prints the screen to a printer 

C control -X] cancels the Vey entry 
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In addition to the commands listed above, there are several parameters 
Mhich can be modified from withjn FDB. These parameters can be used to 
allow FDB to read and write sector oriented protected dists, and set 
internal FDB operating parameters. Here is a list of some of the more 
useful parameters, along with their initial default values, and a 
description. 

0007«00 Requested output volume number or zero, if same as input 
volume. 

0008=00 Begin track to process. 

0009=22 End track to process. 

0010=08 Maximum read retry count. The retry number is displayed as 
1-9 for the first nine revolutions of the disi and A-Z for 
the next twenty-six. After that the display will not 
change. 

0011=03 Maximum verify after write retry count. 

0012=10 Motor On delay for read. Ma>:imum value is 7F. 

0013=10 Motor On delay for write. Maximum value is 7F. 

0014=80 Seel Off delay for read. DOS uses FF, the longest value. 
A value of 00 is satisfactory and will reduce the overall 
copy time by about a second. 

0015=80 Seek Off delay for write. It is not recommended to change 
this value below 80 because the drive may begin writing 
before the seek mechanism has settled. 

0016=OB Number of self-sync before address field. This number is 
expressed in excess-5 notation. For example, the default 
of OB will write sixteen self-sync nibbles and the value of 
01 will write h self-sync nibbles. Setting this value very 
low will create a disl: which cannot be written to because 
writing a data field would over-write the subsequent 
address field. Setting this value too high will cause a 
problem fitting all of the sectors on the track. 

0017=08 Number of self-sync before data field. If this value is 

too low, neither DOS nor FDB will be able to read the data. 
Setting this value too high will cause a problem fitting 
all of the sectors on the track. 

0018=00 Alternate writing to drive 1 and 2. Setting this flag to 
FF Mill cause FDB to alternate writing between two drives, 
allowing for very fast and efficient disk copying from 
memory. 

To change parameter* within FDB, enter the 4-digit address and press 
return. The current value will be displayed and you can key over the 
value to change it. 

While the copy operation is in progress, the ESC key can be used to 
cancel /abort the copy operation. The 'V key can be used to turn on or 
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turn o^f the verify-af t er-wr i te f 1 ag . 

Locksmith will read and write a disk wi thout RAM boards in 19 seconds, 
copying 10 tracts per pass. I -f verifying after each write, the disl' is 
copi ed X n 2.6 seconds . 

The following table summarizes timing tests done with some popular copy 
programs wi thout the use of RAM boards: 

time time to 
tr^s/ to c op y 8< 
Program pass copy ver i f y 



Locksmith ^.O 10 19 26 

Penulta Copy 5 38 

Disk Muncher 7 26 

Pad Rat 4 35 

Apple COPYA a 88 



Also note that Disk Muncher and Pack Rat do NOT validate checksums during 
read, and are thus ex tremel y unrel i abl e. 

If RAM boards ^re found to total at least lOOK (t2aK RAM boards work 

fine), the disk can be read in O seconds, and a copy dis^ written in 8 

seconds. If ver i f y-af ter-wr i t e is desired, the disk is written in 15 
seconds . 

The foil owi ng t abl e summar ises timing tests done with some one-pass copy 
pr ogr ams with the use of 1 28K RAM boards: 

1 1 me 1 1 me t i me to 
to to wr i te it 
Program read wr ite verify 



Locksmith 6.0 8 8 15 
Copywriter 24 16 23 

Copy Cruiser 9 16 23 

Note that CopyWr i ter al so has a 'read-twice' mode whi ch takes 45 seconds 
to perform instead of 24 seconds, but can be more rel i abl e on or i g i nal 
di sis recorded on quest i onab le media. 
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CLE^Rr -TRr^CH:: ST^~rLJS O I SI=-l-*=*V 

C/] CLR STATUS 

The track status display at the top af the screen i^ not cleared after 
each Locksmith function, so that the user can use the status display with 
other functions. To clear the status display, press the '/' key from the 
main menu. 

CN3 DISK EDIT 

Press I ng 'N' from the main menu v^ili 'select the Di':^^- Editor. Thi'i 
function was referred to as the Nibble Editor in previous versions of 
Loc^smlth, but it has been ejpanded to be abl e to edit sectors, ent ire 
tracts of sectors , DOS f i 1 es, and RAM card data in additi on to disk 
nibbles. The keystroke 'N' to invoke it has been kept for compatibility 
with earlier versi ons of LocVsmith. Some text in this manual may still 
refer to it as the Nibble Editor. 

The following single Keystroke commands are supported by the disk editor: 

CESCl 

Pressing the ' ESC key will always abort the current operat i on and 
return you to a menu. 

CCTRL-Zl 

Thi s opt 1 on is act i vated by pressing and holding the key mark ed 
'CTRL' and pressing the ' Z* key. Thi s opt i on i s a screen print. It will 
pr 1 nt whatever i s showi ng on the te:< t screen at the 1 1 me it is pressed. 
This IS assuming that you have a pr i nter turned on and that Locksmi th has 
been told the correct si ot for the pr i nter inter f ac& card. 

Now we will cover how to move around within the buffer. 

CURSOR MOVEMENT: 

The disk editor cursor consists of a flashing box on both sides of the 
nibble or byte of data. 

LocV smi th supports the normal Appl e II cursor movement k eys. 

UP 
111 
LEFT CJ2 CKl RIGHT 

cm: 

DOMN 

You may also move left or right with the left and right arrow keys. 

I f you have an Appl e //e the up and down arrow keys are also oper at i onal . 

I f you move left past the beginning of the line, you will be pi aced on the 
last character of the previous line. Similarly, if you move past the end 
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oi the current 1 i ne, you will be pi aced at the begi nning of the next line. 

C<3 

Pressing the ''"' Vey will move bacV wards through the buf-fer one 
screen page, unl ess you ar& already at the begi nning of the buf-fer . 

Ol 

Press I nq the *>* key will move forward through the buffer one 
screen page, unless you are already at the end of the buffer. 

Press ing the ',' key will all ow you to scrol 1 cont i nousl y back 
thr ough the buff er un t i 1 ei ther a key is pressed or you reach the 
beginning of the buffer. 

C. 1 

Press 1 ng the '.' hey will all ow you to scrol 1 cont i nousl y forward 
through the buf f er unt i 1 ei ther a key is pressed or you reach the end of 
the buffer. 

DISPLAY CONTROL COMMANDS: 

CA] 

This key toggles the display of ASCII data to the right of the hex 
display. The ASCII display is normally meaningless for nibble data, so it 
is normally turned off. 

This J-ey toggles the display between nibble mode and byte mode. 
In nibble mode, sel f -sync nibbles are di spl ayed in i n verse tex t , wh lie 
normal nibbles (not self-sync) are displayed in normal te:<t. In self-sync 
mode, all data is displayed with the high order bit turned on, because all 
nibble data by definiti on has the high order bit on . In byte mode, all 
data IS displayed m normal text with the high order bit of each byte left 
i nt ac t . 



CONTROL KEY COMMANDS: 

CCTRL-RD 

Pressing 'CTRL-R* will allow you to read a track into the buffer. 
You will be prompted with TRACK; . I f you have previ ousl y read a track 
into the buffer, that track number wi 1 1 al so be di spl ayed . The Current 
default drive for the track read will also be di sp 1 ayed - If you wi sh to 
reread the same track just press the RETURN key. If not then enter the 
number of the track you wi sh to ex ami ne. You may enter a dec i mal poi nt in 
the track number. The track number you enter will be multiplied by four 
before it is stored internally. This is necessary due to the way 
Lac^smith finds the tracks specified. After you have entered the track 
number you wish, press the RETURN key to tell Locksmith you are finished 
with the entry. The cursor will move to the dri ve entry to all ow you to 
change the default if you wish. If you want the default drive, press 
RETURN. The first time you read a track into the nibble buffer Lochsmith 
will recalibrate. If you wish to recalibrate at any other t i me enter 
CTRL-R and when the prompt TRACK: appears enter the track number, followed 
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by 'R' and press the return ^ ey . This will iarce Locksmith to 
recal ibrate. 

CCTRL-W3 

Entering a 'CTRL~W' tells Locksmith to write the current tract' 
bact- to disk. You will be prompted with TRACK:. t\nter the number of the 
tract" you wi sh to be wr i tten to the disk foil owed by return. Press i ng 
return will write the data to the current track that was read. Next the 
cursor will be placed on the default drive number for the write. If you 
wish to use the default drive just press RETURN. If you wish to change 
the default, enter the number of the drive you wi sh to wr i te to. 
WARNING' IF NO ANALYSIS HAS BEEN DONE ON THE TRACK TO SET THE TRACK START 
AND TRACK END LOCKSMITH WILL ATTEMPT TO WRITE THE ENTIRE BUFFER. 

CCTRL-V: 

This command is used to tell Locksmith where to start verifying 
the tract^^ start after it writes the track to the disk. The ser i es of 
bytes that follow the verify start are the ones that are checked when the 
track IS wri tten to disk. This is done to mate sure that the beg i nn i ng of 
the track was not overwr i tten and destroyed by the &nii of the track. 
Normally, if the ver ify bytes ^ire overwr itten the track will be shortened 
and rewritten until they i^ra not overwri tten or uritil the tract can no 
longer be shortened. If the tract can no longer be shortened you wi 1 1 get 
a verify error. Thi s error may possibly be corrected hy adjusting the 
copy drive to a si ower speed prior to writing the track. 
To set verify start, place the cursor on the nibble you wish to start 
verifying, and press CTRL-V. This will set the verify start to this 
location- There will be a 'V displ ayed i n front of ttie nibble you 
sel ec t ed for ver ify start. 

CCTRL-I ] 

This command is used to add nibbles to the current buffer. When 
you enter ' CTRL- 1' the nibble that is at the current cursor 1 ocat i on i s 
dupl 1 cated and all the nibbl es to the right ^re moved one posi t i on to the 
r I gh t . 

CCTRL-D] 

Th i s command i s used to delete nibbles from the current bu f f er . 
When you enter 'CTRL-D' the nibble that is at the current cursor location 
IS deleted from the buffer and all the nibbles to the right of the cursor 
are moved one posi t i on to the left- 

rCTRL-F] 

Thi s command is used to find different patterns of nibbles within 
the buffer. Enter CTRL-F, and you will see the prompt FIND:. Tfte Find 
Command has two opt i ons: 

CRETURN] 

Pressing the return key will cause find to use the pattern in 
the string variable PATO. You can set this variahle with tfie LPL 
command processor described elsewhere in this section of the manual. 

tLD 

Entering * L ' will give you the prompt LENGTH:. You may now 
enter in a length from (1-F). This instruction tells Loctsmith to 
start loot>ing forward through the buffer for a pattern that matches 
the one that starts at the current cursor position and is LENGTH 
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n 1 bb 1 e-b 1 ong . When the pattern is found , the cursor will be moved 
forward in the buf-fe-r to the first nibble of the matching pattern. 
If you wi sh to repeat the search from your present cursor posi t i on , 
type 'CTRL-F' and press the RETURN key. This repeats the last search 
again. If Loct smith is unsuccessful in its search for the pattern, 
the cur sor will not move and Locksmi th will print in i n verse at the 
top right of tfie buffer 'NOT FOUND' and beep. 

Earlier versions of the Nibble Editor had three other options to the Find 
command. The O ( f i nd other ), P (find pattern name) , and D (find data) . 
Because of the capability of using LPL directly from within the Disk 
Ed 1 tor of ver SI on 6.0, these opt i ens Are no 1 onger needed within the Disk 
Ed 1 t or . The equi val ent LPL commands are: 

NEXT. DIFF finds the ne>;t nibble in the buffer di f f erent than the one 
at the cursor. This is equivalent to the find "0" (other) option. 

FIND PAT4 finds the next occurrence of the data contained in the 
variable PAT4. This is equivalent to the find "P" (pattern name) 
opt 1 on . 

F IND D5 AA 96 finds the next occurrence of the data suppli ed by the 
user. This is equi val ent to the find "D" (data) opt i on . 



CCTRL-B3 Moves the cursor to track start. If the cursor is at track 
star t, the cursor is moved to beginning of buf f er at 2000. 

CCTRL-E ] Moves the cursor to track end. If the cursor is at track end , 
the cursor is moved to the end of buffer at 7FFF- 

t<] Sets track start to current cursor position, 

C) ] 

Sets track end to current cursor position. 

CSD 

Sets the nibble under the cursor to sel f sync . 



Sets the nibble under the cursor to normal 

CC] 

Change mode. Enter hex data and press RETURN to e:<it change mode. 
You may al so use the left and right arrow keys and the space bar in change 
mode. This changes the data under the cursor to the hex values entered. 
Pressing the space bar moves the cursor to the next positi on- The 
commands 'S' and 'N' also work in change mode, 

CHI 

Entering 'H' will display the current buffer on the hi-res screen. 

chg: 

Entering a *G' while in hi-res mode will print the hi-res screen 
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if you have a printer capable of hi~res graphics and a graphics printer 
interface card. The printer string reqcii red by your pr i nter may be 
defined by the parm 'GRCHARS'. The default is set to CTRL-I G <CR: CTRL-Q 
vCR>. This string works for both Si 1 en type and Epson printers with 
interfaces that support graphic screen dumps. 

Enter i ng a ' G' from the te;< t mode of the Ni tjble Edi tor will 
di spl ay a picture of the buf f er using text character^i. Each 1 oca ton on 
the screen represents a string of nibbl es in the bufft-T. The 1 eny th of 
the string (sample interval) is defined by the parm ' TSAMP' , and defaults 
to »0A. (Note: for 13 sector disks, a value of %0C wor ^ s well). On the 
graphic display the foil owi ng symbol s are used . A per i od ' . ' means that 
all the nibbles in the string ^re normal (non-sel f sync ) . An inverse '#* 
means the nibbles are all self sync. The ' + ' means the nibbles a,re a 
combination self sync and normal. 

The cursor may be moved within the screen ArQa using the I,J,K,M ^eys or 
the arrow keys. The cursor may be moved to the locati on on the screen 
correspond i ng to the Are a in the nibble buf f er that you wish to examine. 
Pressing any other key at this point will return to the nibble display 
with the cursor set to the are a you sel ected. 

HINT: The display starts at either buffer start or track start and the 
display may not be centered. Move the cursor to the center of the screen 
and press the RETURN key. It will take you back into the Nibble Editor. 
Set tract, start '(' and press 'G' again. The display will now be 
centered . If thedisl you are examining is a 16 sector di sk , you will see 
one pattern of 'It's that is larger than the others. This is the field of 
sel f sync in f ront of sector zero. Move the cursor to the first peri od 
' . ' foil owl ng the large number of '#'s and press RETURN- You will now be 
back in the Nibble Edi tor and the cursor shoul d be near the first nibble 
in the address header for sector zero. 

Th is IS a 16 sector address decode command . You will see two 
col umns di spl ayed on the screen . They are decoded in the foil owi ng 
manner . 

The first f our numbers in inverse are the buffer address. Ne;< t is the 
letter 'V foil owed by a hex number . Th is is the vol ume number of the 
disk. Ne;< t I s a two digit hex number foil owed by a '/' foil owed by 
another two digit he:; number. This is the track number /sec tor number. 
This field may be followed by any of these three symbols ' "" , ' CS' , ' »* ' or 
if nothing is wrong it will be followed by a blank space. They have the 
following meanings. The '?' means that either the chect- sum or the 
trailer was incorrect in the address field. The *CS* means the data field 
checlsum is bad . The ' »* ' means there is somet hi ng wr ony with the data 
field information. It is either a bad data field header or trailer. If 
the disk IS a 13 sector format, '**' will appear for all sectors. 

As inent i oned above, '»*' indicates that either the data field header (DS 
AA AD) or data field trailer (DE AA) is incorrect. If they both appear 
uurrect , but are st i 1 1 mar I ed with '««', the trail er is probably m the 
wr ony 1 ocat ion. Exact I y 343 nibbles should occur between the header and 
the trailer. <342 data nibbles and one checksum nibble) A simple way to 
te^t this is to perform the following. Place the cursor on the DZ ui tfie 
header field (D5 AA AD). Now, press '"-■' (shifted) 3 times, 'I' 5 times, 
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ftedder field ( D5 AA AD). Now, pr f^^s ' ' (shifted) Z times, 'I' 5 times, 
and 'f' twice. The cursor i la now where t\\& trailer should start. M the 
cursor IS not on the Dt of the trailer (DE AA) , the trailer is not in the 
c or r ec t 1 ocat i on . 

The address field nittbles occur in doubl e-nibble for mat af t er the address 
* 1 tl d f leader (D5 AA 9t.) and r epre^ent the vol ume number , t r ac k number , 
set t ur number , aruj chfc k sum. A chart to decode the address field 
doub le- nibbles is located in the append i x . 

The data field nibbles consist of 342 data nibbles after the data field 
header ( D5 A A AD) plus ^n additi anal 343rd nibble, whi ch is used for the 
data field checksum. This checksum is calculated by taking each of the 
342 data nibbles, tr an si at i ng t hem ace or ding to a chart < whi ch is suppli ed 
in ttte appendix;), and exclusiveur'ing them together to form a checksum. 
The resulting cttecksum is then reverse tr ansl a ted using t he same t ah 1 e and 
bet uiiies the 34 5r d ni bh ! e. Not e that on ly 64 differ ent ni bbl es are pr esertt 
in this table. Data fields Ar ^ vali dated onl y by this 6-hit checksum, and 
data nibbles eath cuf*tain only 6-bits of infor mat i on each . 

If the disk is using a non standard address or data header you will not 
receive this information unless you set PARMiSECAF to the correct address 
field pattern and FARM:SECDF to the correct data field pattern. 

ni3 

Pressing ttte '*»' key from within the Nibble Edit or prints the 
current track in the buffer from ' < * track start to ')' track end to your 
prirtter. Ttie self sync nibbles will have *•' on either side of them i n 
the pr 1 ntout . The track verify start will have the letter *V' in front of 
the verify start nibble sequence. 

rRETtJRNl 

Fr essi ny the RETURN ley places the prompt "t.PL: " above ttie data 
td'.pl.iy. Ytiii (nay filter dii\ {.V\ statement at this time- The I P'L statement 
may tie a SHOW ccimatand to display the value of a named variable, a 'v .^r lable 
iwmit' assignment statement, or a processing routine to invoke. See the 
ituipter un LKL for mure i ri f or ma 1 1 or* . 

[CTRL S] 

F r essi ftg c ont r ol - S will process the analysis porti oti of the 
curretit trail procedure. This is used after reading to anal yie the nibble 
data and set pointers f or 1 at er wr i 1 1 ng. 
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F^F«rf=*MI IMCS BIX ^M/^L_V2:E:Ft 

The fraaiing bit analyser is intendfi^d a& a tuul for ttiu more advanced 
Lockami th ussr . 

Fr ami ng bi t& f&omet i mes call ed "&ync bit5** or "timir, ^>ite") are the z era 
bttii that occur between &om* nibbles of data on the ^J i 'i.l^ . These ni bbl es 
Ml t h f rami ng bits are call ed self-sync nibbles. Each bit of ni bbl e data 
r equi r es 4 mi croseconds to read or Mr i te. An 8-bit tubbie of r am di sk 
data with no framing bits therefore requi res 32 mi cr usee onds. Fur each 
f r ami ng bit occurri ng af ter the G-bi t nibble^ 4 micr usecunds Ar^ added to 
this 1 1 me. A lO-bit (2 f r ami ng bit) sel f~sync nibble tfierefore r equir es 
40 All croseconds to read or wr i te. 

13-sector DOS (DOS 3.2 and earlier) used 9-bi t self sync (1 framing bit) 
while 16-sectQr DOS (DOS 3.3 and PKQDOS) use 10-bit self sync (2 framing 
bits). It IS also possible to write 3 or more f r ami ng bits after a nibble 
of data al though if 3 or more framing bits occur, it is mure likely that 
sync may be lost by the disk controller while reading. 

Some copy protecti on techni ques rely on sel f~sync data with a specific 
number of framing bits on a specific nibble of data un the track. This 
can be dfc^tected in a number of Mays. One way to determine framinij bit 
I n f or mat i on is to cause the disk control ler shift register to deliberately 
lose sync. This c au ses the normally invisible framing bits to bt* stiif ted 
into the disk controller shift register. This method doesn't work with 
some models of disk drives. Another method to determine the number of 
framing bits is to perform a statistical analysis of the timing of the 
disl data using sever al reads of the same data. 

The framing bit analy::er per forms a statistical anal ysis using precise 
timing loops and reports the timing relationship of the nibble data. The 
framing bit analyzer reads the track data repeatedly, each time updating 
cummulative timing statistics for each nibble of data. After several read 
passes, this timing information can precisely determine the number of 
timing bits used to Mrite any nibble of data on the disk. 

The framing bit analyzer is entered by pressing '♦' from the dist editor 
at ter reading in a track from di sk and manual 1 y set 1 1 ng certain poi nt ers 
I i> the tr dcl> buffer. 

Let's use an e;^ amp I e to describe the use of thie fr ami ng bit anal y ^' er . In 
the disk editor, use ttie control -R command to read a tract of nibbles. 
Place ttie *' ( " start pointer on the start of an address field ( D5 AA 96). 
Move the cursor down about 10 lines and set the ")" end pointer. Now move 
the cursor back up to the "DE AA" after ttie start of the address field (D^ 
AA 96) . 

The framing bit analyzer uses the data from the start pointer "(" to the 
nibble immediately before the cursor as a "key". If you placed "(" before 
the D5 nibble and the cursor on the DE nibble, the key lengtfi would be »0B 
(decimal 11) ni bbl es. 

Enter ttie f r aming bit analyzer by pressing the "%" t ey. Thie .Ji spl .ly sfiows 
the data being analyzed on the left side of trie screen with statistical 
1 nf or mat i on on the right. 
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The following command l.eyii control the framing bit analyzer: 

The space bar tempurarily ^tops the analyi'er ^o you may examine the 
statistics. Pressing the space bar again Mill cause a single read to 
oc c ur . 

The Rt TURN key starts the analysis again. 

EBC e:;its the framing bit analyzer and returns to the disk editor. 

" < " and " "> " al 1 ow you to scrol 1 through the buffer if it is mor e than 
one scr een in 1 ertgth. 

"T" switches the display fr om nibble data to the timing statistics 
information associated with each nibble. 

The timing statistics information associated with each nibble would be 10 
for ati ideal normal 8-bit (no framing bit) nibble, 20 for tin ideal 9- bit 
(1 framing bit) nibble, 30 for an ideal lObit (2 framing bit) nibble, and 
so on. Timing statistics between these "ideal" values indicate 
differences between the writing artd reading drive speeds and statist ii.al 
error due to thie number of samples read. This error is reduced when mure 
samples are taken. 

the r ight side of the screen is a statistical summary 
d mi ght 1 ook like the foil owi ng : 



The 1 nf or ma 


1 Ott Oft 


of the analysis tin 


K 


^0O07 


F- 


=07 




7"* 




— + + 





02 


1 


00 25 


2 


25 03 


Z 


02 GO 


4 


01 01 


5 


00 la 


h 


OB 00 


7 


OO 07 


B 


03 



The "R^ " va 1 ue is the number of reads wh ich occurred. The "F-" value is 
the number of reads in which the "key" of the data was found on the track, 
because of limited buffer space, if a large data length is specified, it 
IS possible that the buffer may not fully contain the data specified. 

Trie table of numbers represents the count of the differences of the data 
r ead wi tti the "i deal " values of 10, 20, 30, etc. These error di f f er enc es 
r ange f r urn - 7 t u ♦?, with OO being the ideal . For e>; ample, in the tabl e 
St. own above, the count fur +1 is 25 (hex). This means that there am 25 
cjt curr euL es of ni bbl es with t immg val ues of one gr eater than the ideal 
val ue (11, 21 , :". 1 . etc: . ) . The "H" count of 03 i ndi cates 3 occur r ences uf 
timing values e;;actly halfway between ideal values. This indicates that 
more samples a^r t^ needed. The "''>^" is displayed when ttie values for the 
+ / <b,7, and G counts ^r B non-zero, and indicates that mure samples are 

needed. 

When nibble data is displayed on the left side, the inverse/normal mode of 
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E?ach nibble indicates, the numbtfr oi framing bit^ dfter ttie nibble. Nor mul 
ttix t 1 ndi cate^ nu f r ami ng bits. Both digitt^ ^r t* inverse if Z! framing bits 
wl^ii I e onl y one digit is inverse if 1 f rami ng bit. A tl ashi ng val ue 
1 ndi CAt«& 3 or more f r ami ng bits. 

If the ni bbl e data has the high or der bit turned off, triis indicates that 
at 1 east on« read occurred where the data after the key did not mati-h. 
Thi & coul d have been caused bya loss of sync whil*^ >ading or by the key 
being specifi ed as too short whi ch c aused a non-un iqi^^ part uf the track 
to be anal yz ed instead of the de&ired part. 
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CL] LOAD RAM CD 

F'ressing the *L' V ey ^rom the main menu will cause tracks ♦12,*I3, and ♦! 4 
to be read into memory addresses *D000 through tFFFF of a RAM card in SLOT 
O. If you have an Apple //e or //c, there is a "built-in" slot O 1 6K RAM 
card already in your system. 

I i you own Inspector / Watson , you can pi ace them on your Loc ^ smi t h disk 
by using the -following procedure and then quickly load the RAM card when 
L.ocl<smith IS booted by pressing 'L' from the mai n menu. 

Your Locksmith diskette already contains a RAM image of INTEGER BASIC and 
the moni tor on tracks ♦I'S and SIA, To install Inspector / Watson on track 
412, foil ow these instructi ons; 

Boot a copy of a disk that cont ai ns your copy of Inspector and 
Wat son - Then enter I n spec tor or Watson , i nsert a copy of your 
Locksmith diskette and press the foil owi ng keys; 

B D O <return> 
T 1 2 'return > 
control -W 

Then press the control -I key 15 ti mes. Inspector and Watson are now 
placed on your Locksmith diskette. 
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F> #^ Fi rf=^ M e: T e: Ft s 

C*3 PARAMETERS 

Pressing the '•' key +rom the mai n menu will all qw ? ou to di spl ay and set 
Locksmith parameters. Parameters Are displayed and modified using their 
parameter name (LPL variable name). 

To ex i t from the parameter f unc t i on press the ESC *ey. 

To display the value of a parameter, enter the ^eyword "SHQW" followed by 
the name of the parameter . For ex ampl e, to di spl ay the current val ue of 
the parameter SLOT, enter; 

SHOW SLOT 

To change the val ue of a parameter , si mp 1 y enter its name ^oll owed by the 
val ue you wi sh to assign to it. For ex ampl e, to change the val ue of the 
par ameter SLOT to 4, enter : 

SLOT 4 

If an error was made in enter i ng the command , tfie speak er will beep , and 
the command will be i gnored. Si mpl y type it again correct 1 y , 

To display the addresses of the parameter names as they atre being 
displayed, set the parameter SHOW.ADDR to the value YES, as follows: 

SHOW.ADDR YES 
Now 1 f you enter the command : 

SHOW SLOT 

the address of the parameter SLOT is displayed in addition to its value. 

Any named Locksmith parameters can be displayed and changed in this 
manner . 

Hure Are a few useful parameters and a brief descripti on of what they are 
used for: 

SLOT is the slot number of the dist- drive Locksmith is to use for 
disk functions. For example: 

SLOT 4 

PRT. SLOT IS the slot number which contains the interface for the 
printer to be used for print, print screen and graphics print 
commands. For ex ampl e: 

PRT. SLOT 1 

6R. CHARS IS a string variable <m-a:<imum 1 ength of I^) wh i c h con tains 
the printer setup string which will cause the interface to print the 
graphics screen. Loct-smi th sends this string to the printer when the 
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'G' V ey i ■B pressed while a graphics screen is displayed in the DisJ 
Scan or Disl Speed utilities. The following statement sets the setup 
string to control-I 'GRD', which will cause Grappler and Gra^Star 
print er interfaces to print the graphics screen rotated and 
doub 1 e-s i z e: 

GR. CHARS 89 'GRD' 8D 

LS. SLOT is the name of the parameter to change the dri ve si ot from 
whi ch Loc^ smith will load overlays f rom. For e;; amp 1 e: 

LS.SLOT 5 

The following stat emen t , whi le not really a parameter , can be useful 
to assist in reading sectors from a disl that reads unreliably. This 
patch to RWTS inhibits the recalibrate of the disk head after an 1/0 
error occurs and instead will retry the read oper at i on unt i 1 it 
succeeds. The second statement listed below removes the patch and 
all ows normal reading of sectors. Note that with this patch 
i nst a 1 1 ed that sector reads for a sector that is permariently bad will 
never termi nate. If this occurs, si mp 1 y remove the bad diskette arid 
replace it with a good one until the read terminates normally. 

BDCC 4C CI PD 
BDCC 10 F3 AD 
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"text etditof^ / l_i="l_ 

:t] text editor 

The Locksmith te:;t editor is entered from ttn3 ma i it menu by pressing the 
'T' Key. The text editor is a special purpose file editor which is used 
to edit Locksmith Programming Language (LPL) files. These -files can be 
loaded from and saved to a Loct smith Parameter Dl^-^tette, which is included 
with the distribution of Loci- smith 6.0. The parameter disl^ette (sometimes 
referred to as the "parmdisk") is not copy protecte.l, yet is formatted in 
a special way to ma;<imi2e use for saving many paraineter files. The free 
space and alphabetical directory on the parmdisl is automatically managed 
by the text editor. 

After entering the text editor menu, the display screen will show the 
following choices: 

cl: load file 
[s3 save file 

[D: DELETE FILE 

[X: SYNTAX CHECK 

CC: CHANGE SLOT AND DRIVE 

Cn INITIALIZE PARtlDISK 

CZl PARMDISK STATISTICS 

[E: ENTER EDITOR 

CN] NEW FILE 

:P: PRINT FILE 

:A] PRINT ALL FILES 

[B: BACIUP / COPY DISK 

By pressing a single key from the text editor menu, any text editor 
function can be selected. 

E<#=>CKI_JI=' US I |N|(3 CUSTOM F=-<^Fi: <^MK ITE R: S 

cb: backup / COPY disk 

This text editor function is used to automatically select a parameter file 
to be Li'jed to bartup a disl with a minimum of teystroles from the user. 
To enter this function from the text editor menu, press the 'N' ley ("NEW" 
clears the wort buffer if any file is currently loaded) followed by the 
'B' ley (backup / copy). 

If the parmdisk is not in the selected drive you will be prompted to 
insert it. After the parmdisk directory is read into memory, a list of 
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parametar files contained on the parmdisk is displayed. The "light bar" 
will be positioned on one o-f the names, probably the -first one i-f no 
parmdisk operations have been previously per-formed. To move the light bar 
to select a di-fferent -file, you can press one of the following keysi 

Cup-arrowD and Cdown-arrow] will move the light bar up and down. If you 
have an Apple II or II PLUS you can use Ccontrol-K] to move up and 
Ccontrol-J3 to move down. 

Ccontrol-N] (next page) and Ccontrol-P] (previous page) can be used to 
scroll ahead or backward one complete page of names. 

If you know the name of what you are looking for, you may enter the first 
character of the name. The light bar will be immediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may use 
the up and down arrow keys to move the light bar. The left and right 
arrow keys move the cursor in the name key-in field. The name key-in 
field always shows the current name selected. 

If while entering a name to select, you enter a character that causes the 
name key-in field to contain a file name that is not in the directory, the 
speaker will "beep" and the light bar will be positioned on the name 
closest to the one you have entered so far. 

To select a file name for backup, press the RETURN key. The file will be 
loaded from the parmdisk, automatically syntax checked, and control will 
be transferred to the Locksmith backup/copy routines after suitable 
prompts for you to insert the Locksmith diskette and finally, the 
diskette(s) to copy. The backup/copy routines will automatically copy the 
proper tracks with the proper LPL parameters. 

cl: load file 

Press 'L' from the text editor menu. If the parmdisk is not in the 
selected drive you will be prompted to insert it. After the parmdisk 
directory is read into memory, a list of parameter files contained on the 
parmdisk is displayed. The "light bar" will be positioned on one of the 
names, probably the first one if no parmdisk operations have been 
previously performed. To move the light bar to select a different file, 
you can press one of the following keys: 

Cup-arrow] and Cdown-arrowl will move the light bar up and down. If you 
have an Apple II or II PLUS you can use Ccontrol-K] to move up and 
Ccontrol-J] to move down. 

Ccontrol-N3 (next page) and Ccontrol-Pl (previous page) can be used to 
scroll ahead or backward one complete page of names. 

If you know the name of what you are looking for, you may enter the first 
character of the name. The light bar will be immediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may use 
the up and down arrow keys to move the light bar. The left and right 
arrow keys move the cursor in the name key-in field. The name key-in 
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-field always shows the current name sel ec ted . 

I i whi le entering a name to sel ect, yon enter a character that causes the 

name ley-in field to rontain a file name that is not in the directory, the 

speaker will "beep" and the light bar will be positioned on the name 
closest to the one you have entered so far. 

When the light bar is on the name you wish to select, press the RETURN 
key. The file will be 1 oaded into the work area. 

ZSl SAVE FILE 

Fress the 'S' Key, If the parmdi-it i^ nijt in the '^eleuted drive you will 
be prompted to insert it. Af ter the parmdisir director/ is read into 
memor y, a list of par ameter files contained on the par md is J i '^ displayed. 
The "light bar" will be positi oned on one of the names, probab ly the last 
n.jme you pr ^ / i olisI y used . To use the same name (replace file), si nip 1 y 
press the RETURN ley. To move the light bar to select a different file, 
you can press one of the following keys: 

Cup- arrow] and T down -arrow 3 will move the light bar up and down . I f you 
have an Apple II or II PLUS you can use Ccontrol-Kl to move up and 
[ i_ont r ol - J 3 to move down . 

Ceontrol-ND (next page) and C control -Pl (pr evi ous page) can be used to 
scroll ahead or backward one compl ete page of names. 

If you Inow the name of an existing file you wi sh to repl ac&f or want to 
name your file with a similar name to an existing file, you may ent er the 
first character of the name. The light bar will be immediately positioned 
on the first name beg inning with the character you entered . You may 
farthur qualify your suggest i on by enter i ng more characters of the name or 
ina y use the Lip and down arrow ^ eys to move the light bar. The left and 
r 1 ght arrow k eys move the cursor in the name key-in field. The name 
ley-in field always shows the current name selected. 

If while entering a name to select for saving, you enter a character that 
Lju--.es the name ley~in field to contain a file name that is not in the 
directory, a new name will be displayed in the key-in ar&a with the words 
"r.DD FILE:" displayed. Key over using 'the space bar, any unwanted 
c^laracter s and press the RETURN key when you are f ini shed speci f ymg the 
fi-iine you wi sh to save. The name will ei ther be added or repl dCed, 
depending on whether the name already e:< i sts. 

MEui — c:i_e<=^b: ETDi-r wof*k ^f^te^ 

CNJ NEW FILE 

Pressing the 'N* ley from the te;<t editor menu causes the te;-,t editor worlv 
area to be cleared. Any file contained in the work area not already saved 
on the parmdist- is lost. If you have made changes that /ou wish to s^ve, 
be sure to save the file before you clear the work area. 
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c::nr^tNic3E: slot «ixid of* r «v"e 

CC3 CHANGE SLOT AND DRIVE 

Pressing th» "C" k»y will prompt you +or a nsM slot numbsr and driva 

number of th» disk to us* for th» param>t>r disk. Either enter a new slot 

and drive number or press the RETURN key to use the default values 
di spl ayed. 

F>«F*«METEF* DISK STATISTICS 

:z: PARMDISK STATISTICS 

Press the 'I' key to display statistics about the parameter disk. The 
information displayed is in two parts. Information about the "CATALOG" or 
diri?ctory is displayed first, followed by information about the "DATA" 
portion of the parameter diskette. Shown below is an example parameter 
disK statistics display. 

VOLNAMElLS 6.0 PI 

DISKETTE STATISTICS 

•«*(• CATALOG ••«(» 

364 FILES 

6071 BYTES FREE 

5705 BYTES USED 

13 AVERAGE FILENAME LENGTH 

ENTRIES WHICH CAN BE ADDED: 

496 AVLRACjE FILENAME LENGTH OF 10 

IBl AVERAGE FILENAME LENGTH OF 30 

*••«* DATA *•*«« 

103744 BYTES FREE 
27329 BYTES USED 

75 AVERAGE FILENAME LENGTH 
FILES WHICH CAN BE ADDED s 
1621 AVERAGE FILE LENGTH OF 64 
405 AVERAGE FILE LENGTH OF 256 
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delete: f\ F>«F*«METEF» FILE 

CDl DELETE FILE 

Praaaing th« 'D' k«y mil allaw you to dalcta m «inul« fil* fro* th» 
paraiutar disk. Sclact a *>!• to dalata In th« aam* way that you Mould 
■alact a iilm to load (dascribad aarliar) and prasa tha RETURN kay. Tha 
fi la Mill ba raiaovad fro* tha paraaatar disk and tha spacia it usad 
raclaiaad. 

IIMI-ri«l_I 2E p-«l=*«METEFt OXSKETTE 

CU INITIALIZE PARMDISK 



Pra»>ing tha 'I' kay iram the taxt aditor menu Mill alloM you to 4urmat 
and initlaliza an empty parameter diskette to stur» additional <ile». 
WARNING: This function erases all data on the target diskette. Enter a 
volume name for the diskette. When prompted Mith "FORMAT?", enter "y" if 
you Mish the diskette to be formatted or "N" if the diskette is already 
formatted Mith standard 16 sectors per track. Press the space bar Mhen 
prompted, to start tha format and initialization process. 

After tha process is complete, you may use tha disk to save additional 
parameters. 



ElMTEFt THE TEXT EO I TOR 



CE] ENTER EDITOR 



Pressing tha 'E' key Mill enter the text editor. To exit from the text 
editor and return to tha taxt aditor menu, press the ESC key. 

If residue exists in the Mork area, you can clear it by pressing control-N 
(NEW) from tha text editor or exit tha text editor (press ESC) and enter 
'N' (NEW) from the text aditor menu. 



USIIMG TME TEXT EDITOR 

The taxt editor is a line numbered editor. All lines entered mck given 
sequential line numbers, Mhich mrm displayed in inverse text on the 
leftmost tMO positions of each line. The line numbers Arm displayed in 
hex. Line numbers Ara used only for referring to a portion of a file Mith 
the ".I" (include) directive of LPL. 
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Lin»« in thm trxi «di t tif- «r • di «pl ay«d on* I i nm a4 t •>« t p«r on» 1 i n» o4 
th«" nppi* 40 column divplAy. With / po«itionm u«*d * or 1 in* numbvr , 38 
p<»« 1 t I tin* «r • all owvd I or th* mami mum 1 vngtH of • t*Kt 1 i n». If it i « 
n»(»««ary to r ont i tut» an I PL «t at «m»nt on tti» n«>tt linv, k*v * Minu« «l gn 
t"~") a« t h» last character »nt*r»d on th« 1 i n« to b* continuvd. Any 
nijmhvr of I i n»« may t h»r •< nra b« u««d to con tat n an LPL at at»f nt . 

Th«»ri» Ar9 two rurmorm u«»d in th» twwt •ditor, II th» 1 i n» nuMb»r ■■ 

♦ lashinq, th» rur mor i « on t h» I i n» nuMb»r . II a •tngl« character on tb» 

lin» im flashing, th» cur aor i« within th« li n* of twxt. Thim l« 

I mpfjr tant for thM In^vrt and d»l*t* f unc t i onm whi ch ar» d»«cr i b»d 1 at vr . 

To ent •r t »y t , « i mp ly typr th» «tat ffM«nt « you *»i mh foil OM«d by thM RFTtlRN 
fcey- The return l-wy c au^Mv t h» cur *or to go to th» naxt lin*. Th» 
hark«par» *>•¥ <l»ft At r nw ) i « u«»d to backup th» cur mor on» char ac t »r 
po^i t I on I* It i« within a li om of t •»< t and mow up on« 1 i n^ i f t h« cursor 
I s on all nm numb»r . 

To md It mn VMisting lin», us* th* RETUf^N k*y or th* 1 *l t arrow to post t i on 
f h9 t ur sor on t h* 1 I n* numb*r of th* I i n* to b* *di tmd , and us* th* 
r I ght ^r r ow t o mov* t h* f ur «or ont o th* t*Mt ll n*. Si mp i y k»y ov*r dat A 
Oft ttt» 1 1 r^v to thang* t h* data. 

To in»*rt or d*l*t* tharactvrs on t h* lin*, position th* cursor within th* 
lin* nv*r th* tharact*r you wi sh to d*l*t* or I ns*r t b*f or*, and pr*ss th* 
cont rol I lc*y to insrrt blank* or th* control -D k*y to d*l wt • char ac t er ». 

Tc> I ns*r t or d*l rt * ffnt ir* lin*s of t*Kt, post t i on th* cursor on t h* 
ntimb#»r of t h* I i n* and pre** th* control-! k*y to ins*rt blank 1 i n** or 
t hf> ( ontr nl D kvy to d*l*t* 11 n*s. 

To *x I t from th* t*xt *ditor and r*turn to th* t*Ht *ditor M»nu, pr*ss th* 
ERC k*y. 

A summar y ol th* t*Kt *d 1 1 or commands i 

EBC •« I t th* t*Kt *ditor 

ctrl-N Nf W - c 1 »ar wor|.ar*a 

RFTURN fflov*s cursor to t h* 1 i n* nu«b»r ol th* n*xt lin*. 

< ' li th* cur*or i s on a 1 in* nuMb*r , mov*s it up on* lin*. 

If th^ t ur »or 1% within a Iin* ol t*wt. otov*« it l*ft on* 
t_ *^Mr Mc t *r po* i t I on . 

> mnv*s th* cursor on* position to th* right. 

Ctrl -I If th* cursor i s on a lin* nu«b*r , 4ns*rt* a blank lin*. 
If th* cursor i« within a lin* ol t«»<t, in**rt* a blank 
c har at t *r , 

ctrl-D if th* cursor ■ s on a lin* nu«b»r » d*1»t*« th* lin*. II 

th* cursor is within a lin* ol t*Ht, d*l*t«m th* character. 

lupl this arrow k*y or ctrl-K MOv*m th* cursor up on* lin*. 
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[Uown] thi» ArroM t^y or ttrl-J mov* tr>« curmor Uumd unm Iiom 



CX] SYNTAX CHtCK 

Pr»«»ing th« 'X' kay mi M c«u** th« t»Mt i i Im tn th* Mor k At m* tu b» 
•c Annrd for syntAx «rrDr%. lit doing »q, aM ".I" iiulmlv Utrvctive^ are 

• Mp«nd»d , ufting th« iiie% whi ch th*y r vf «r vocit. It you (ifc» .1 i ommandH i ri 
yuiar t*«t, b« mur* to i.4v» t htt fit* ttmiarm yuu «yntAK chock, b*cAiim« 
feyntAx chack Milt ch^ng* ths fil« in aMtinur y . 

Af t «r »»pandi ng «ny .1 commandm «nd syntax checking tha rvvultiog LPL 
«tAt«A*rit«, th* m*k&4g« "SYNTAX CHLCK SUCCtSbl^ UL" mi t 1 «pp*«r it no errors 
M«rv found. 

If *ny arror* M«r • found, th« t«>*t aditor i« mt^t9rmct with tha cursor on 
tha «tatamant that cauhad tha mr r or and tfta *paakar wilt tiaap. No 
chacking t* dona bayond tha firat mrror th*t uc(-ur«. 



F>FtIIN4X ^ F>^Fc^MEXEFt FILE! 

IP] PRINT FILE 

Pra%%ing tha 'P* key from tha taxt ad it or manu mi 11 pr j nt trm t or r ant f i 1* 

in tha MorkAraa. Iha ttandard printar »lot is u»ad (dafault of slot I), 

but iitAy bm changad by »atting tha paramatar for tha printar slot to a 
d 1 f f ar ant vaI ua. 



[A) PRINT ALL FILES 

Pre»»ing the 'A' kay Mill print tha antira contanl* of tha paramatar disk, 
ona file at a tima, in *lph*batic*l order. 
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Ih 1 HAMCKD UT IL 

Pr e^^ I (ig ' H' from thv Loc k ««ii th aai n nivnu Mill di mpl «y t h* RAH c Ard 
ut I 1 1 t I es mvnu . 



All HAM c 4r d% f ound in slotm O through 7 on th* App 1 • Mrm di sp 1 jiyad a1 ong 
Ml t h the «tmuunt ai mmmur y v^ch cont «i ns . App 1 • / /• And App t« //c h^v* *n 
iftteroAl 1 6K o4 Mvmur y which App*«r • ak ttlot O Although no physical slot O 
d(tu«illy trxi&tK. AuKiliAry m^Mur y , found on th» Appl* //« ^nd built m on 
t tiw App li* //c, i« not t e<bt«d by thi& utility at thi% ti ma . An upgr «d«d 
HAM c Ar d t ai^t utility Mill includ* tvfttfc for «ux i 1 i «r y Mitinor y fur th« 
App t e / /e And App 1 ■ / /c . 

befifc'dit h t tie 51 UT RAIi display Are i^ever a1 menu i tea choi c e* . 

tiel etting 'T' Mill perform a NAM c*rd reAd/write test. I* mor e I rtan one 
h i lit I urtt dins A HAn l Ar d you Ar e pr ompt ed fur the «lot number . bnt er a 
slut numtjer Mttich LontAins a HAri c Ar d . Then vetect ' ti' or ' L' to indicate 
wttettier A bASic or an extenkive test should be performed. Ttte basic test 
r ufi'3 1 '*'U t 1 mes f Ast er t hAn the ex t ens ive test but it is not as t thorough . 
AMer selectiitg ttie type of te*.t, specify 'S* or ' C for single test or 
L urt I I nuuiis t est . C(jnt i nuous mode shoul d be me 1 ec ted f or det ec 1 1 ng 
intermittent errors on the RAM card. 

WT) lie the test is running, a mess Age ttimilar to the foil omi ng one i m 
displAyed on ttie screen: 

Tttn oooa bANt- t» PAbt D6 ALT 

T ri 1 s me*>sage srioMS the sequent i a 1 test number (if in cortt i nuous mode ) , the 
ban^ numtter , and page number currently being test ed . Memor / pages fr out DO 
thriiugtt Dt have alternate memor y pAges , Mhi ch , when sel ec t ed , d i sp 1 Ay 
"Ai I" after the pAge number. 

Tfie test lan he terminAted by pressing the ' ESC ' key , suspended tiy 
pfe^^ing the spaie t)ar, and continued by pressing the 'HI TURN' key. Like 
all toLksmith tunctictns, the results can be pri nted by pressing l untr ol 1 . 

n any errors Mere tound. An »r r ur message siMilar tu the fullOMing one is 
(1 1 sp 1 ayed . 

MKKUK WKITINlj AA(2A) AT etBl ON BANK I 

I he message shoMS the test set^uence number , the bank number , trie address 
ot trie error. Mttat mas wr i t t en And MtiAt mas reAd bAck in paren thesis. If 
4ki<iy other addresses in the tiAok of memory chArtged vAlues spont Aneousl y 
<Mri lie other 1 oc at 1 ons of the bank M«r e bai ng Mr 1 1 tan ), they miM be 
1 1 -st etJ also, Mitti tt^e prefix "«" on the er r or mesa age . 

\\\f ex t ens ive ter^t writes ea(ti of the ?^6 possible values to each of the 
1 t>i at I ons of t tie HAM tard, and then reads back the m^knm 1 oi At i on to i naur * 
that trie value Mas indeed stored correctly. It a1 so chec k s a1 1 other 
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I or at 1 onm o' t hw PAfi rard to mjtl » %\.tr » t ti«t no cit. Hi»r 1 or at i cin« M»r • 
modiMvd. THv hasi( tv%t t« th» «am« am tfi* »Htf*n«iv» lv%t, rwi »p t that 

inmtvad nf all pn««ibl» /f>6 valu»«. it ii«»» two tr»t valu**^ ('^'^ and AA ) . 

I f any fT r or « w»r » * oitnd, you may want toe on<i»i It t h» HAM t ar d manna I t o 
d«t«rain» tti« lofatlun of th» faulty RAM rt>ip», or tah* th» RAM card in 

* or mmr VI c I ng . 

r>iJMF^ ROM rz^\f^Ty xo Mff mcir y 

S»l •€ t I ng * n ' fr om t hr RAM c ar d A*nu will all ow you t o dump t h» c ont «»n t m 
t»* th» RAM rard, I AK at a t i mr , into niaii> m»mr>r y , »c) tfiat it r ar» h» 

• m ami n»d . Thr lixlsmith dl*V and mvmor y »d l t or ( * N' * r cim t hf» m j i n mpnii > 
(. ari t>v ti«*d to edit thv m*mnr y . 1 6K at a t i m« i« dk^impvd to main memory 

1 ocat 1 on« :,'000 t o M f » a« * ol 1 owmi 

7000 ?FrF RAM r af d pag»« DO OF ALT 

^OOO-^Ffr RAM lArti pag»n DO DF 

40<K> 4f F F RAM card pagvY to fF 

5000 ^Ff^ RAM card pag«« F O FF 

I < t h» RAM r ar d you hav» vrlvct wd l« larg»r than t AK , you will hm pr (jmpt ed 

♦ or th» bank numl)»r . F or a 1 2B*( card, bank* f r om O to ? ar» valid. 

Fressintj *l' will load th« RAM c *r d * r om ma l n memor y. Ttiim fnficti or» i & 

the r»ver»» o< thr 'D' <dump > f unc t i on . 1 ('>K at a t I m» i * I oattwd * r om mai n 

m»mor y to thn s«l«ct«d bank of th« RAM card. 
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CQ] SCAN DISK 



This utility Mill h«lp you to d«t»rinin» what track* ara in uaa on a diak 
you *rm trying to copy. 

Pressing 'O' from tha main manu Mill put you into tha scan diak utility. 
This utility is u&ad to detarmina what tracks on a diak contain valid 
data. Yau Mill be prompted for the drive number you Mish to u^e and then 
for the starting tracks ending track and increment between tracks. 

The display is a hi-res graphic display of the sync bytes on a disk. The 
graptiic display of a track runs from the bottom to the top of the screen. 
The first time you run this utility you should do it on a normal DOS 3.3 
disk. First try tracks O to 22 in Mhole track Increments. This Mill shOM 
you Mhat a good track will normally look like. The series of dots you see 
on ttte screen above each track number Arm the gaps of self sync bytes 
betMeen each sector. Normally on a 16 sector disk there Mill be 16 or 17 
of these dots. This is because Locksmith alMays reads long enough to read 
the Mhole track into memory and it may have read mora than the Mhole 
track. Similiarly a 13 sector disk Mould have 13 or 14 of the little 
dots. On a 16 sector disk one of the dots Mill be a little longer than 
the others, that is the self sync group in front of sector zero on that 
track. If you look closely you can see a definite pattern to the longer 
dots, they Mill either move up or doMn as you move from track to track on 
the disk. This is due to the time it takes to move the disk drive head 
from track to track. 

Now using the same disk try scanning from track .5 to track 22.5 Mith an 
increment of 1. You will see very long lines of Mhite in no particular 
pattern. This means there is no valid data on the track. li you see some 
evi dence of sectors (shor t bursts of Mhi te) , the rm*d head ex per i enced 
"cross-talk" from adjacent half-tracks perhaps (but not necessarily) due 
to a misalignment in either the reading drive or the drive that Mrote the 
diskette. 

If the disk IS using a protection scheme called spiral tracking you will 
see the long band of Mhite but there Mill also be a pattern of black in 
between the Mhite. The black sections Mill not be right next to each 
other but Mill be offset slightly as you move across the tracks. This is 
due to the time it takes the disk drive to move from track to track. The 
mure that you use the scan disk feature the more valuable you Mill find 
it. This IS because you Mill become more adept at interpreting the 
resul t s it gi ves you. 
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#=*Lj"roM*=^x I c: BOOT t-i=%#=*c;e:f« 

CA] BOOT TRACER 

The Automatic Boot Tracer is intended *or use by the more experienced 
Apple programmer. It is actually a sophisticated debugger which can 
simulate the operation of the 6502 in the Apple. Because disk reading is 
simulated, it is possible to actually "boot" a disk (whether protected or 
not) under control o* this debugger, and trace the boot code oi the 
program. 

Boot tracing, a normally manual and very tedious technique which is used 
by the most sophisticated "hackers", can be performed automatically under 
control of the Locksmith Automatic Boot Tracer. 

To invoke the boot tracer, key 'A' from the main menu. You must have a 
RAM card of at least 16K on your system for ABT to work. If you have An 
Apple //e or Apple //c, the "built-in" 16K RAM will work. 

Locksmith ABT will prompt you for the slot number of the RAM card. Key in 
a digit from O to 7. 

The ABT will be installed on the RAM card you choose, and the ABT will be 
entered . 

Note that in this manual, the ABT (automatic boot tracer) is also referred 
to as the debugger and the si mul at or, since it actually si mul ates the 
operation of the 6502, and can be used as a powerful debugger. 

The screen will clear and a line of inverse text will appear on the top 
line of the display. The ABT is now operating. 

If you press reset at any time, you will be placed in the Apple monitor 
and can reboot another disk by entering the slot number followed by 
control~P. Be careful not to reboot a disk which will automatically load 
over the ABT on the RAM card you selected. 

In%-fc3r-m^i-tic3r-i I i.r~i^ 

The top line of the screen whi ch appears in i n verse tex t is a one-l i ne 
status display which appears initially as follows: 

FA62 CLD A=00 X=00 Y=00 P'=34 S=FD 

The first 4 characters Arc the program counter (FA62 in this example). 
The 6502 opcode at the program counter is al so d i sp 1 ayed (GLD in this 
example). Next, the values of the A,X, and Y registers are displayed. 
The "P==" value is the processor status register contents, and the "S=" 
value is the stack pointer. 

At this time, press the R key followed by a key from A through X. Notice 
that the information line disappeared and moved to another line of the 
screen. You can put the information line on any line of the screen that 
IS convenient for the software you will be debugging / tracing. If you 
don't want the information line displayed, you can place it on row Y or 2 
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(which are oif the screen). 

I cJ 1 @ Meddle 

The simulator is in "idle" mode at this time. That is, the program to b« 
simulated is not currently running, but is stopped at the address 
displayed by the program counter. 

Press control-C at this time to enable the processing of 65C02 
instructions. This is necessary if you Ars running on an Apple //c or an 
enhanced Apple //e. 

Press the S key to start exectution under control of the simulator. The 
ABT is now running simulated 6502 code. The simulator is now in "running" 
mode. Note the rapidly changing program counter. The "beep" you hear 
from the speaker may sound a bit different than the Apple "beep" Mhich you 
Are used to, but that is only because under control of the simulator it is 
slowed down considerably and sounds lower. 

Ta stop the program bei ng executed , press C control — Z 3 . You Are now agai n 
in "idle" mode. Control -Z is the def aul t character used to stop execut i on 
of the simulated program, but it can be set to a different "stop" key if 
you need to be able to use control-Z with the software you are tracing. 
To change the "stop" key, first stop the program being executed and return 
to "idle" mode by pressing control-Z. Then press control-X followed by 
any other key, and the other key will be used for the "stop" key. 

To reset the "stop" key to control-Z, enter idle mode and press control-X, 
control-Z. 

Enter idle mode. Now press the space bar and watch the information line. 
The space bar is used in idle mode to single-step one instruction- A "+" 
or "-" will appear after each conditional branch instruction, depending on 
whether the branch will be taken ("+") or will not be taken ("-"). 

Mhile in idle mode, enter control-Y. You are placed in the system 
monitor, and can enter any monitor commands such as "L" (to disassemble 
6502 code). To re-enter the simulator, press control-Y, RETURN. Before 
placing you m the system monitor, the simulator saved low memory pages 00 
to 07 on its RAM card. After re-entering the simulator, this memory was 
"refreshed", insuring that no memory was inadvertently changed while in 
the system monitor- 
To review the idle mode commands we have already learned: 

Space-bar single steps one instruction. It can also be used to 
"single-cycle" (see below). 

"R" moves the information line to rows A through X. 

"8" starts th« slmulmted program running and enters "running" mode. 

Control-Y enters the system monitor. To re-enter the simulator, press 
control-Y again, fol lowed by the Return key. 

Control-X is used to change the program "stop" key, which stops the 
program and enters idle mode. 
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Othar idl* nod* connandsi 

"T" (tracB subrautln*) vKBCutam tha simulatad program until a JSR or RTS 
instruction im fatchsd. 

Control -R caumas a "simulatad" rasat to occur. Tha program countar la 
fatchad -from •FFFC. 

Control-I causa* a "simulatad" IRQ Intarrupt. 

Control-F turns o-f-f the "simulatad" IRQ panding -flag. 

Control-N causas a "simulatad" NMI intarrupt. 

Control-Q quits tha simulator and raturns to tha systan monitor. 

Control -RESET also ax its tha simulator. 

"1" is usad to sat singla-cycla moda. In singla-cycla moda, tha spaca bar 
cyclas ona 6302 procassor cycla at a tima, instaad o-f an antira 
instruction stap. 

"0" is usad to sat instruct ion-stap moda. It is valid only whan on an 
instruction boundary (not on a cycla in tha middla o-f an instruction). 

"B" turns tha "baap" -flag on and o-f-f. Tha baap is soundad whan idle mode 
is entered. 

"C" turns the "click" flag on and o-f-f. The click is sounded -for every 
keystroke when not in "running" mode. 

Control-C turns the 65C02 -flag on and of-f. The de-fault value -for this 
switch is "of-f". If 65C02 instructions »rm to be simulatad, this -flag 
must be on. The Apple //a (enhanced version) and Apple //c both contain 
65C02 processors and use 65C02 instructions in their resident ROM code. 
Note that tha simulator itsal-f does not use 65C02 instructions. You can 
therefore run 6SC02 instructions on a normal 6S02 processor. 

"K" Mill take the next key pressed and place it in the keyboard character 
register. Mhen Instruction stepping through code that reads tha keyboard, 
this key allows a convenient way to enter a keystroke to the program being 
traced, without entering the keystroke In "running" mode. 

"ESC" is used to enter tha simulator control menu. The simulator control 
menu is used to display and change internal simulator control information. 

S± muiX «i-t:.C3i~ Ccarrti^caX Ul± rtdov* 

Press tha "ESC" key while in idle mode. Tha simulator control window Is 
displayed, and tha cursor appears in the upper left of the window. 

Use the RETURN key, and the left and right arrow keys to move tha cursor 
around the simulator control window. These keys only move tha cursor and 
do not change any information in the window. To change data anywhere in 
the window, simply position the cursor over the value to change and 
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re-enter the desired value. To exit from the simulator control window and 
return to idle mode, press the ESC key again. If you wish to cancel any 
changes inade in the simulator control window, you may press control-C 
instead. 

Let's look at the simulator control window in detail. 

The top line looks very much like the information line in idle mods, 
except that the program counter appears further to the right and no 
instruction is disassembled on the line. The number on the left of th« 
line is used for single-byte reading, single-byte writing, and memory 
editing. Enter an address value followed by ' H' to read, 'W to write 
(also specify value to write), and 'E' to edit, using the memory edit 
wi ndow. 

To change display modes for the simulated program (text, graphics, hi-res, 
low-res, pagel, page2, fullscreen, mixed), key in the address to toggle 
(*C050-»C057) and enter 'R', Mhen tracing a program in graphics mode, it 
1 s useful to put the i nf ormat i on 1 ine on rows U, V, M, or X , and toggl e 
mixed mode graphics. The simulator will display the information line on 
either text page 1 or 2, whichever is selected by the program being 
SI mul ated. 

Enter an address , foil owed by ' E' to enter the memory edi t window. 

Mhile in the memory edit window, the memory is displayed in both hex and 
ASCII text. The cursor can be moved with the RETURN key and arrow keys. 
To change data, si mpl y key in a new val ue in the appropr i ate address. The 
ESC key returns to the si mul at or control window, saving all changes to 
memory. If the changes made in the memory edit window are not to be 
made, enter control -C. 

The second line of the simulator control window contains: 

RU=65 0=1 1=1 2=1 3=S 4=1 5=1 6=D 7=1 

"RU-65" This value (decimal 101), the "register update" value, represents 
the number of i nstruct i ons that Are si mul ated before the regi sters and 
program counter are updated on the screen, when in "running" mode. If 
this number is set small (01 for example), the registers will be updated 
after every instruction. This however causes the simulator to run less 
efficiently, because of the overhead involved in updating the information 
1 ine. 

SXcDt Sp>^c:±-f±c:«fc"t:ix€nn^ 

The rest of the second line displays the slot numbers and how they are to 
be used. Because the si mul at or resides on a RAM board (indi cated by ' S' 
i n the si ot di spl ay , for "SYSTEM" ) , it must know about al 1 other RAM 
boards and firmware boards if it is to correctly simulate their operation. 
Initially, the slots will be set to 'I' (invalid). Any reference by the 
simulated program to these invalid slots will cause the simulated program 
to stop and control is passed to idle mode. Val id ttlot mpaclf Ication 
values Arei 

' S' system (si mul at or ) si ot 

'I * 1 nval I d 
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'D' floppy disk drive 

'A' RAM card of 16K or 32K. 

'B' RAM card oi 64K or more. 

'F* Firmware card or ROM card. 

' T* transparent . 

li the specification for a slot is "transparent", any commands for the 
device m that slot will be given without any checking or conversion by 
the sifflul a tor . Transparent mode should not be used for : 

Any devices such as RAM and ROM cards that bank select memory into 
the address range DOOO to FFFF, which is used by the simulator. 

Any devices such as disk drives which aret timing dependent, as the 
simulator runs much slower than the 6502 in native mode. 

Any devices which may use DMA (direct memory access) to modify memory 
from addresses «0000 to *07FF, as this memory is used by the 
simulator with a copy of the user's memory actually residing on the 
simulator's RAM board. 



The third line of the simulator control window starting with "PC" is the 
"PC compare stop " line. Up to four program counter val ues for "compare 
stop " can be spec i f i ed. If the simul a ted program' s PC equal s one of these 
values, the simulator immediately enters idle mode. In addition, one "PC 
compare stop range" can be speci f ied. To enter program counter stop 
values or a range, change the number (initially "O") to the number of stop 
addresses to be entered and then enter the addresses in the space 
provided. To disable PC compare stop, set the number back to "0". 

The "MR" line of the simulator control window is the "memory read address 
compare stop " line. Like the "PC compare stop" line, up to f our addresses 
and one range can be speci f i ed- Whenever the si mul a ted program attempts 
to read one of these addresses, ei ther by di rect addressing, indirect 
addressing or stack fetch, the simulator enters idle mode. 

The "MW" line of the simulator control window is the "memory write address 
compare stop " line. Idle mode i s entered whenever the si mul ated program 
attempts to write to one of the addresses specified here. 

f=- 1— CD Q r- ^i fT» C C3UJH-* -t ^ r- Si^^l(D 

The "PCSW" AreA of the simulator control window is the "program counter 
swap" control area. Up to four address pairs can be specified here. If 
the simulated program's PC equals the first value of a pair, the PC is 
immediately set to the second value, and execution continues. This is 
very useful for eliminating slow timing loops, which are unnecessary in 
the simulator. Initially, 3 pairs of PCSW values are given. They arei 
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FCA8 FCB3 - This nullifies the monitor wait routine. 

BAOO BAIO - This nullifies the DOS 3.3 seek delay routine. 

BD9E BDAB - This nullifies the DOS 3.3 motor-on wait routine. 

R" r- c=> g 1^ ^i m C C3 i-i n t e» r- "Ti^^icz^ ~r^it:> 1 ^ 

The bottom eight lines of the simulator control window contain the PC 
trace table. The last 64 values of the program counter are kept here, so 
that when the simulated program is halted, a history of the last 64 
instructions can be examined. 

A program running under control of the simulator halts and the simulator 
enters idle mode whenever one of the following conditions is met: 

The "stop" key is pressed by the user. 

An invalid 6502 or 65C02 opcode is encountered. "777" jg displayed 
in the information line where the opcode is normally displayed. 

A JSR or RTS instruction is fetched while running with the "T" 
(trace) command. 

A read or write to the device select addresses of a slot marked as 
"I" (invalid) in the slot table. 

A compare stop occurs for PC, HR, or MW, while running. 

An attempt is made to write to the floppy disk. 

An attempt is made to reference certain I/O addresses. Among these 
Are 40060 and *C06B for either read or write. 

Note that in the case of a compare stop for MR or MW or an invalid device 
select reference, that idle mode is entered with the PC containing the 
address of the instruction <after> the one that caused the compare stop. 
Look at the last address in the trace table to find the correct address. 

Ir»t^r-r-i«3il Ofzt ^t^ ^i^ ± or^ ^kX Nc=>-tiC9^ 

A few notes on the i nternal operat i on of the boot tracer / si mul at or / 
debugger : 

Floppy disk reading is simulated by reading in an entire track of nibbles 
and passing them one at a time to the simulated program requesting them. 
Each time the simulated program requests a nibble, the next nibble in the 
buffer IS returned. The simulated program never has to wait for a nibble 
by polling the high-order bit of the disk register. Because of this, 
framing bit timing is not preserved- In addition, the track is not 
synchironized to any other track upon reading. Floppy disk writing is not 
supported . 
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When reading a -floppy disk, the simulator maintains the nibbles of the 
most current track on the simulator's system RAM card. This track image 
is valid unt i 1 ei ther the si ot or dr i ve number i s changed or resel ected, 
or the read/write head is stepped to a different track. Only if the 
current track image is invalid will the real fl oppy di sk be read agai n . 
Therefore, if the user performs a "CATALOG" operat i on whi 1 e under control 
of the simulator and then changes the diskette and performs another 
"CATALOG" operation, the catalog information from the first disk will 
still be di spl ayed because the catal og ( 1 ocated ent i rel y on track * I 1 ) did 
not cause the head to change tracks and invalidate the track buffer. To 
manually invalidate the track buffer, change the slot specification to 'I' 
and back to 'D' while in the simulator control window. 

The simulator has code for "sector assist" built-in. This means that when 
the simulated program requests a nibble followed immediately by testing 
for disk register ready and a compare for tD5, the simulator Immediately 
finds the next 405 in the track buffer and returns it to the simulated 
program, instead of requiring the program to ignore each nibble until the 
value 405 is found. 

The paddle I/O addresses («C064-«C067 and *C06C-»C06F) are correctly 
simulated if the code that accesses the I/O addresses is similar to the 
monitor routine at SFBlE (PREAD) . If the reference is not similar to the 
moni tor rout ine, idle mode will be entered . 
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CC] CERTIFY DSK 

The dtb.t certify function of Locksmith is invoked by pressing 'C from the 
main menu. It can be used to check a diskette for physical dantaQe prior 
to use. 

THIS UTILITY DESTROYS DATA ON THE TARGET DISK. 

Enter the output drive number, the starting track, ending track, and track 
J ncr emen t . Inser t the diskette you mi sh to test , and press the space bar 
in response to the prompt to insert the diskette. 

This functi on works by wr iting a specific pattern of nibbl es onto every 
track you specified. It then reads this pattern back to verify that it 
can read what was written. If Locksmith is unable to read what it wrote, 
it Mill flag the tract as bad . There can be three di f f er ent reasons for 
thie track being fl agged as bad. First it may not have been wr 1 1 ten 
correct 1 y due to a disk dri ve mal f unct i on. Second 1 1 may not read 
correctly due to a disk dr i ve mal f unc 1 1 on . Thi r d and most litely t^^e disk 
med la is que^ti ondb I e, espec i al 1 y if several adjacent tracks di sp lay 
er r or s. 

Mheii Loiksmith checks the disk it will wr i te a per i od (.) in the status 
area * ur every track that checks good. If a track checks bad it will be 
flagged with ^n aster isk (*). 
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l4£. SECTOFt U-riL_ITIEQ 

This function glv«« you accaaa to aavaral utilltias daaignad to work with 
normal 16 aactor (ganarally unprotactad) dlaka. Thaaa can ba DOS 3.3, 
PRODOS, CP/M, or any atandard 16-aactor diak. 

To tnvoka any of tha 16-aactor utilltlaa, flrat praaa 'U' from tha main 
•lanu. 

±£i SECTOFl DISK VERIFY 

tva 16 SECTOR FAST DISK VERIFY 

Praaaing 'V from thia aubmanu Mill taka you to tha FAST DISK VERIFY 
utility. You will ba promptad for tha driva numbar of tha diak you wish 
to varify. Lockamith Mill than procaad to raad tha diak from track O to 
track •22. 

On tha atatua display at tha top of tha acraan, a pariod '.' maans the 
track raad corractly. An aatarisk ' t' maana tha track did not raad 
corractly. A nurabar reprasanta tha numbar of axtra timas tha diak had to 
apln to raad all aactora corractly. A numbar '1' for axampla maana tha 
track had to ba raraad onca in ordar to raad corractly. 

BaloM tha atatua dlaplay la tha track/aactor diaplay. On tha track/sactor 
diaplay tha aymbola hava tha following maaningi 

A pariod '.' maana tha aactor was read correctly on the flrat diak 

revolution. 

An inverae character 'A' meana there waa aomathing wrong with tha addraaa 

field or the addreaa field waa miaaing. 

An inverae character 'D' maana there waa aomathing wrong with the data 

field. 

A number indicatea that tha sector waa read correctly, but that it took 
several rereada to read it correctly. 

1 <£. SECTOR FORMrtT 

CFl 16 SECTOR FORMAT 

Preaaing 'F' will allow you to format a diak. This utility will format a 
diak or a range of tracks with the volume number you apeclfy. This could 
ba very useful if a track had been deatroyad accidently. In thia case the 
disk would normally be unusable. However with thia utility you could 
almply reformat tha one track and uae the diak. 

THIS FUNCTION WILL NOT RECOVER DATA THAT MAS ON THE DESTROYED TRACK. 

You will flrat be prompted for the diak drive you wlah to uae. Praaa 
either '1' or '2', depending on which drive you wlah to uae. You will 
then be prompted for track start, end and increment. Specify the tracka 
you wiah reformatted. You will next be prompted for Volume Number. 
Specify the volume number that you wiah to format in the Addreaa Field. 
Following the Volume Number, you will be asked which Track Numbera to use. 
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Normally, the defaults will be used. Since it is possible that you may at 
some 1 1 me Mtsh to use a nan -standard i or mat , this is left up to the user . 
For example, some protected dists currently on the market use tracks ♦06.5 
through ♦22.5. These tracks Are formatted with track numbers »06 through 
♦22. 

±4^ SECTTOF* DISK COMF^AF^E: 

tC] 16 SECTOR COMPARE 

Pressing a "C from this submenu Mill allow you to compare two disks for 
differences. When you select this option you will be asked for the drive 
number of the disk yuu wi sh to compare. Thi s rout ine stores a daub I e-byt e 
(16-bit> t heck sum for each sector in memory and compares it to the one 
alre-.ly ihere. If they don't match you will get a 'C on the sector 
number display. Mhen reading the first disk to compare, it is normal to 
get many 'compare errors' because incorrect sector checksums are initially 
in memory. 

After the disk you wi sh t o compare i s read into memor y , take it out of the 
drive and replace it with the disk you wish to compare tu. Press the 
space bar to begin compare, arid any sector that matches wi 1 1 have a period 
'.' on the sector display for that sector. If a sector doesn't match 
there will be a letter 'C on the sector display. The checl'Sums that were 
there f ram the original disk have now been repl aced by those of the disk 
you just compared , so i f you pressed the space bar agai n wi thout remov i ng 
the disk just compared you shoul d get all peri ods ' . ' on the sec t or 
display. In additi on to the '.' and 'C', you may al so find inverse 'A' 
and 1 n ver se ' D' . These indicate address field and data field errors, 
respect i vel y . 

X ^ istzcxoF* SYiNjc: SI Grv4rf^-rLJF<e: 

[S3 16 SECTOR SYNC SIGNATURE 

Thi„. utility is used to obtain a signature of the sync pattern on a normal 
16 sector dls^- This can be useful when wor king on synchroni 2 ed di s^ s. 
You will be pr omp ted for the disN drive you wi sh to use. Enter either '1' 
or ' ?' . Thi s routine starts at track »00 sector ♦00. After reading this 
sector, it moves to tract- 1, and displays the first sect or nuniber that it 
encounters. This continues until all ^22 tracks have been checked. 

Thic sync signature is displayed again and agai n . It may be slitjfitly 
difierent due to disk speed varaiations from time to time. To terminate 
ttie sync signature rout i ne, press ESC . 

1 1 1 add 1 t i on to checking synchroni 2 at i on , this routine can be used to 
determine what copy progr am created a gi ven 1 6 sector dist>ette. 

A sync signature on ^ 16-sector distette will normally sJiow a progression 
of hex numbers, ei ther ascend i ng or descend ing. For example, ttie 
foil owl ng pr ogres si on stiows hex numbers descendi ng by one: 

0FEDCBA9876^4 32l0f EDCBA9876543210FE 

We Will identify the above progressi on as (-1), to indicate that each hex 
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digit IS one 1 est> than the one before. The following table shows several 
copy programs, and the progression iderttifier that identifies the sync 
signature for a disl which was created by that specific copy program. 
Note that simply writing data to a disk will not change its sync signature 
- the disk must actually be formatted or generated by a copy program that 
formats the disk. 

Program signature i dent i f i er 

DOS INIT 0DA741EBa5. . . (-3) 

Loc ksmi th 
Format 04BC048C (+4) 

Lock smi t h 
Fast Backup 0FEDCBA9B7 (-1) 

Penulta Copy 0ECA8 <'2) 

CopyWr 1 ter 

(no verify) OOOOOOO. . . . (+0) 

CopyWr 1 ter 

(verify) 0FEDCBA987 . . . (-1) 

Disk Muncher 0DQ52FC964 . . , («») 

Pack Rat 0DB5630DA5. . . («») 

Note that the signatures will have the same progression throughout the 
signature only if tfie disk was recorded in a single pass without turning 
the drive off between tracks. For example, the following signature w^s 
generated by Locksmith FAST DISK BACKUP in a single pass copy (with ITBK 
f<AIi board) : 

0FEDCBA9B76543210FEDCBA9B76543210FE 

Note that each hex digit is one less than the previous digit. This is in 
agreement with the table shown above. Now compare the following 
SI grkat ur e: 

0FEDCBA9a73210FEDCBA6543ri0FED9a765 

Note that the progressi on is the same (-1), e;.cept that at 3 places 
( I dent ified by arr ows bel ow the signature), where the prugressi on is ( -4 ) . 
Th 1 s IS because this signature is fr om a disk that was created by 
Locksmith FAST DISK BACI UP running without RAM cards. Notice that every 
10 trac^s, a break in the pr ogres si on occur s. Thus is because wit li out RAM 
cards, FAST DISK BACKUP copies 10 tracks at a time, and then nf^ii-:, the 
or iginal disl again. So onl y groups of 10 tracVs r ema in in syni. with ejih 
other. Inci dental ly, the break in the progr essi on was (-4). If the disk 
was created by Locksmith FAST DISK BACKUP with verify after write, tlie 
break in the progr essi on woul d have been (-3). As you can see, a lot c an 
be deter mi ned about a disk using sync si gnature. 
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DOS 3.3 LITIL-I-riES 



CD] D0S3.3 UTIL 



Prassing tha ' D' k>y sntara th« DOS 3.3 utititi» nianu. Sal*ct any option 
from this m*nu and you will b* promptad for tha Input driva to usa. Tha 
input driva Mill also ba usad to rewrita data, if tha function raquiras. 

CATrtU-Oe OISK 

Pressing ' C from tha DOS 3.3 utilities roanu will display tha catalog o-f 
the disk in tha current driva. Deleted files are marked with a "D" in the 
front of the file name. 

I—OAD DOS F^II—E IIMTO l-IEMOFtV 

Pressing the 'L' key will allow you to load a DOS file into memory for 
editing with the disk editor. After answering the prompt for the 
filename, the file is read into memory from ♦2000 to aTEFF. The TSL 
(track / sector list) is placed in memory at *7F00, so that the file can 
ba rewritten to disk from the disk editor. 

SMOUJ D I SK SF>rtCE M«F» 

Pressing the 'M' key will display a disk space map on tha screen. The 
sectors are displayed down the left and right sides of the screen. Free 
sectors Arm indicated by "-" and used sectors are indicated by "#". Press 
tha space bar to enter the utilities menu. 

F^IX SEICTOF:* COUIIMTS 

Due to errors within DOS 3.3, the sector count of a file in the catalog 
sometimes gets set incorrectly, usually to zero. Pressing ' K' from the 
DOS 3.3 utilities menu will allow you to automatically correct the sector 
counts on the disk. The sectors for each file are counted and compared to 
the information in the catalog. If the counts Ara not equal, the filename 
and the counts ArB displayed and you Artt prompted to press the space bar 
to correct the sector count for the file. Press the space bar to correct 
the sector count for the file or press the ESC key to abort the function. 

VEFtlF^Y VTOC: I NT"EC3R I TY 

Tha VTOC (volume table of contents) is a bit-map of the free sectors of 
the disk volume. The catalog is a list of names, each with a chain of one 
or more TSLs (track/sector lists) which define the rest of the sectors in 
the file. If a user's program falls while files are open for output and 
they are not properly closed, tha VTOC and catalog can get out of step. 

Pressing 'V from the DOS 3.3 utilities menu will perform a VTOC/catalog 
Integrity verification. The display will appear much like the disk space 
map display (function 'M') and contain both "-" (free sectors) and "#" 
(used sectors). In addition, 3 types of errors arm detected and 
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displayed: 

Sectors which are allocated in the bit map but not used in any ^iles are 
displayed with an inverse "A" (allocated, not used). 

Sectors which are used in a -file but not allocated are displayed with an 
inverse "U" (used, not allocated). This is a critical situation because 
the ^ile data of the affected file can be overwritten if another file is 
all oca ted over it. If this situati on occurs, do not use this disk. 
Immediately copy the files to a blank disk using the FID utility found on 
the system master diskette. 

Sectors which are allocated to more than one file at a time are displayed 
with an i n verse "2" (2 f i 1 es all oca ted) or an i n verse "3", etc. This 
SI tuat 1 on indicates that one of the f i 1 es overwrote the other one. You 
should copy the files to a blank disk using the FID utility found on the 
system master diskette. 

f^etmov/e: oos f^rom d i sk 

Pressing the 'R' key will allow you to remove the DOS boot code from the 
disk, freeing up 32 more sectors. Note that onl y tract s 1 and 2 (16 
sectors each ) are freed . Track O coul d be freed but DOS i s unabl e to 
all oc ate fil es on track zero even if it is marked free. 

A disk space map is displayed. After pressing the space bar, DOS is 

removed from the diskette, the VTOC i s rewr i t ten , and a disk space map is 
again displayed. You will notice that tracks 1 and 2 now contain free 
sec tors . 

LJisi— de:i_ete: ^ i=^ i i_e: 

Pressing the 'U' key from the DOS 3.3 utilities menu will allow you to 
un-delete a file which was previously deleted. Enter the filename when 
prompted . If the fil ename cannot be found, an error message will be 
displayed. If the file has not been overwr i t ten by another file, it will 
be un~deleted and returned to the catalog. If the file has already been 
overwritten by another file, a message will be displayed and the undelete 
will be aborted. Press the space bar to return to the utilities menu- 

Pressing the 'A' ^ ey will allow you to alphabetize the filenames in the 
catalog. Af ter the names have been read into memory and sorted , you will 
be prompted to press the space bar to allow the alphabetized catalog to be 
written back to the diskette. 

E:Mc:F=tYF^-r ^ f='ii_e: 

After pressing the 'E' key (encrypt file), you will be asked to supply the 
name of a file to encrypt. The catalog is checked to verify that the file 
exists. You are then asked to supply a password for the encryption. The 
password you enter will not be displayed on the screen, but you will need 
to enter the password again to verify that you entered it correctly. 
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If both password entries ^re identical, the -file is encrypted using the 
password you supplied. Da not forget the password - it is the only way to 
decrypt this file. If the encrypted file is displayed, it will appear as 
meaningless garbage. If the password is forgotten, the file will probably 
remai n that way forever . 

Di£CZFtYF>"r F^II—^ 

Pressing 'D' from the DOS 3.3 utilities menu will perform a file 
decryption function. This is the opposite of the encryption function 
described above. The procedures are the same as the ones for encryption 
of a file. If you decrypt using the wrong password, the file will remain 

as meaningless garbage. 

Note that if a file is encrypted twice (perhaps by two individuals, each 
entering their own password ) , that the decrypt i on shoul d be done in the 
reverse order . For ex ampl e, if a file is encrypted first with password 
"LOCK" and then with password "SMITH" , the order for proper deer ypt i on i s 
first with the password "SMITH" and then with "LOCK". 

After data is encrypted, i t shoul d be backed up . Thi s is because if an 
attempt is made to decrypt the file with the wrong password , the file is 
scr amb 1 ed more. To reverse a decrypt i on i n error , perform the encrypt i on 
using the same password, and vice versa. 
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*=>dv<^mc:ed disk fsecoverv 

CXa DSK RECOVER 

When you notice a problem with your disli drive which causes disk I/O 
errors, either on a permanent or intermittent basis, it's best to have 
your drive checked. 

What if you have important data which you've backed up using the 
mis-aligned or faulty drive? 

Locksmith Advanced Disk Recovery (ADR) will recover data which cannot be 
read from a diskette due to one of three problems: track mi s-al i gnment , 
off-center hub clamping, and improper disk speed. 

Proper track alignment is more critical than disk speed when reading and 
writing data to a diskette. While disk speed, once set, usually remains 
constant; track alignment, because it is affected by normal mechanical 
wear of the drive mechanism, can change with time. 

While disk drive track alignment should only be attempted by a qualified 
technician, there are some warning signs that indicate improper track 
alignment of your disk drive. Track mis-alignment should be suspected if 
data which was written on a specific disk drive is difficult or impossible 
to read using a different disk drive. This symptom does not indicate 
which drive is mis-aligned, but merely that an i ncompat i bi ty exists 
between the two drives. Sometimes the mis-alignment problem is compounded 
because the writing and reading disk drives are mis-aligned in the 
opposite direction- For example the writing drive may record a track 1/4 
track too low and the reading drive may attempt to read the track 1/4 
track too high. The resulting difference of 1/2 of a track is enough to 
make the data impossible to read. Even if the reading drive alignment is 
correct, the resulting difference of 1/4 track is enough to make the data 
read unreliably, especially on the inner tracks of the diskette (higher 
track numbers) where the data density is greater. 

While track alignment problems usually manifest themselves gradually over 
time, a problem due to off-center hub clamping (more common on older 
drives or diskettes without hub rings) is usually quite sudden and severe. 
When the disk drive door is closed, the hub clamps down on the center hole 
of the diskette. If the media is slightly off-center when the door is 
closed, it is usually centered as the hub clamps it into position. 
Sometimes the diskette is clamped off-center. If this is done before 
reading a diskette, the resulting abnormal head-seek noise is usually 
noticed and simply opening and closing the drive door will re-center the 
diskette properly. If, however, the diskette is clamped off-center prior 
to formatting and writing, the diskette will be formatted and written with 
no adverse symptoms. The data on the diskette can even be read and 
verified, however, once the diskette is removed, the data will be 
unreadable because it was written with the diskette off-center. Any 
attempt to read this off-center diskette will fail. 

Writing sectors to a diskette on a drive which is running too fast can 
cause the following sector's address field to be over-written. Although 
the data field of the sector is Intact, the missing address field will 
cause an I/O error when attempting to read the sector. 

Locksmith Advanced Disk Recovery will recover the data from a diskette 
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recorded ei ther off -center , with bad track all gnment , or with missing 
set.tor address fields, and write the data to a blank formatted disk. You 
musit previously format the disk upon which you wish to place th« rttcovmrmd 
data, (You may use the Locksmith l^-sector disk format utility to do 
this. ) 

Specify the source and target drive numbers and the starting and ending 
track numbers (usually 00 to 22) and Locksmith Advanced Disk Recovery will 
read the problem disk on the integral as well as half-tracks and 
quarter -tracks as needed to recover the data sector by sector . If you 
wish to perform a test run to determine if LDCt<smith ADR can recover the 
datti wi thout actual 1 y wr iting the recovered data, speci fy a target dr i ve 
number of zero. Six tracks are processed at a t i me. The recovered data 
IS wr 1 1 ten to the target disk, unl ess zero was speci f i ed for the target 
disk drive, m which case no writing of recovered data is performed. 

The track status display area at the top of the screen shows the status of 
writing the data to the target disk. The bottom part of the screen is 
used as the sector status display. The numbers appearing in inverse text 
down the left and right sides of the sector status area ar e the sector 
numbers for each track . The order of the sectors in the sector status 
area is the same as the sector order on the track (0,7,E,6,D,...). A 
single status char ac ter is pi aced in the sector status area f or each 
sector to indicate the status of the sector read: 

A period (.) indicates that the sector was read from the correct track 
with no errors . 

An ( 1 n verse A) indicates that the address field for the sector was never 
f ound . 

An (inverse D) indicates that the address f i el d was found but the data 
field was not read cor recti y . 

A plus sign (+) indicates that the sector was correctly read from a higher 
track, half-track, or quarter track . 

A minus sign (-> indicates that the sector was correctly read from a lower 
track, half-track, or quarter track. 

A semicolon (;> indicates that the sector was missing an address field, 
but that this probl em was corrected . 

Note that only the (inverse- A) or (inverse-D) indicate an unrecoverable 
error . 

The fol lowing f igure shows a sample screen after Advanced Di sk Recovery 
h js recovered data from an of f -center disk: 
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DSK RECOVER 
.00 
.25 
.50 
.75 

HE X OOOOOOOOOOOOOOOO 1111111111111111 0000 
TRK 01234567e9ABCDEF0123456789ABCDEF0123 

0++ — . +.-.+,-+.-,+,-.+. — +. — +. — +. ~o 

7+. — + + --.+-,+.-++--.+.-,+. — +.-.+.-7 
E+. -, +, -, ++—. -♦■-.+. — . + — . +. ~. + — . + — E 
6+. -. +, -. +, -. +-. +.— . +. — . + — . . — . + — 6 
D+ — , +. -. +, -+. -. +. -. +. -. +. — . . — +. --D 
5. — ++ — ++. -+, - ++ — . +-. -, +.-, +. -. +. — 5 
C. -.+.-.++ — +. -+. — , + — . +.-.+--. +. -.C 
4.-,+.-.+.-.+-.+.-.+, — ,+ — .+--.+--.4 
BD- + + .-.+,-.+-.+.-. +.-. +. — . +'--+. — + B 
3A. ++ — ++.-. .-, + — , +.-.+. -.+.-,+. — +3 
AA. +. -. ++ — +. -+.--+. — .+.-.+.-.+--. +A 
2A. +.-,+. -.+.-+.-.+, — +. --.+,-..--.+2 
9. ++.-.+■.-.+-.+. -.+,-.+. — +.-.+,--.+9 
1 . ++ — ++. -.+-.+--.+.-.+.-.+.-.+.-.+. 1 
8. +. -. ++ — ++-. +-.+.--.+.-.+.-.+--.+.9 
F. +. -.+. -.+. -+. -. +. — +. — . + — +. --. +-F 

Note that when the sectors are arranged in the same order i n wh i ch they 
appear on a track, the plus signs and minus signs on a track appear in 
clusters. This indicates which sectors were -found on higher track numbers 
(inward toward the center o-f the disk) and which were -found on lower track 
numbers (outward toward the edge of the disk). 

It is common, when recovering data -from an of-f-center disk, to have some 
sectors on track 00 which could not be recovered, because to recover them 
would require reading below track zero, which is physically impossible. 
This is usually not a problem, since DOS does not normally use track 00 
■for storing user data. 
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DISK SF^-EED TES-T 

CS] DISK SPEED 

Pressing 'S' from Locksmith's main menu will put you into thB disk speed 
utility. Depending on which overlay you have in memory at the time, you 
may be asked to insert your Locksmith disk to load the program. The first 
question will be which drive number. Then you will be asked which of 
three types of speed check you wish. The first is to calibrate your drive 
to 300 RPM. This is the normal drive speed recommended by the 
manufacturer. 

The second choice is to calibrate your drive to the optimum drive speed. 
This speed is recommended for copying disks, since it runs slightly slower 
than normal. This helps to ensure that an entire track can be written, 
irregardless of the drive speed of the original. 

The third option is to calibrate your drive to the same speed as the drive 
on which the original disk was written. You will be prompted to insert 
your original disk in the drive. This is to allow Locksmith to determine 
the original drive speed. After inserting your Locksmith disk to load an 
overlay, you will then be given three choices for the graph scale. 

You should normally choose fine adjust. The other two options are for 
disks that Are so far out of adjustment that they can't be seen on the 
fine scale. After you choose the type of graph you wish. Locksmith will 
prompt for the number of samples you wish per plot. 

The choices you have on the above menu are used by Locksmith to determine 
how many times to check the speed prior to plotting a point on the hi-res 
screen. Normally you would select one sample per plot. This will check 
the drive speed once for every point it plots on the screen. 

Next you will he asked to insert a blank disk in the drive you selected 
for the speed test. After you press the space bar Locksmith will write 
and read from track zero of the blank disk. You must use a blank disk for 
this test since the data on track zero will be destroyed. 

ER«^SE DISK 

CEl ERASE DISK 

This function is used to entirely or partially erase a diskette. 

Pressing 'E' from the Locksmith main menu will take you to this utility. 
THIS UTILITY DESTROYS DATA ON THE TARGET DISK. 

You should place the dis^ you wish to erase in the drive of your choice. 
Locksmith will prompt you for the drive of the target disk, the starting 
track number and the ending track number you wish erased, and the 
increment between tracks. 

After you t-iave specified the above information, Locksmith will prompt you 
to insert the disk to be erased. After pressing the spacebar. Locksmith 
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will proceed to erase the speci fied tracks on the disk. 

When the program is finished erasing the speci-fied traces, it will return 
you to the main menu. The status area is not cleared. Every trac^ that 
was erased will have an 'E' in the status Area. 

Some disk protection schemes require that a track never have been used. 
The only way to accomplish this is to use either a new disk or er^-^s the 
track on a disk which has been previously formatted. 



CI] INSPECTOR 

If you have previuosly loaded Inspector /Watson onto your RAM card with the 
main menu *L' (load RAM card) function, boated with a DOS disk that loads 
the Inspector /Watson onto a ram card or if you have a firmware card with 
these programs on it then pressing 'I' from the main Loc^smith menu will 
place you in either the Inspector or Watson. 

The Inspector /Watson program works exactly as documented in the respective 
manual s, with the foil owi ng excepti on . When Inspector /Watson is gi ven 
control from Loc^smith, the default buffer address will be $4000 instead 
of tOBOO. This is because ♦0800 is reserved for Locksmith use. 

If you only have the Inspector, control will be passed to the Inspector. 
If you have both the Inspector and Watson then control wi 1 1 be passed to 
Watson . All the normal program commands Are useabl e, with the excepti on 
of the ESC function (see next paragraph). To exit Inspector /Watson press 
'CTRL-C* and you will be back in Locksmith. 

If your Inspect or /Watson resi des on a RAM board in slot O, the ESC key 
will also return you to Locksmi th . If your I n spec tor /Watson is in ROM, 
you must use ' CTRL~C' to e:< i t . 

For informati on regardi ng the use of Inspector /Watson , pi ease refer to 
their respective user ' s manual s. 
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LOCKSMITH F=-F*OCSR*=^MM I MG L ^iNlCBLJrf^GE: 

Locksmith Programming Language (LPL) is a tool which the LQC^smith user 
can use to speci-fy how Locksmith is to perform certain functions. With 
it, the user can set up a procedure to backup a di f f i cul t-to-copy disk, 
automat i cal 1 y search for and change data on a disk, repai r damaged data, 
etc. Almost anything that can be done with Locksmith can be done 
automatically by specifying the proper LPL commands. 

LPL commands, or statements, are collected into a file. This file can be 

entered from the keyboard by the user or may be 1 oaded from a 

spec I al -format parameter disk <whi ch is incl uded with your Locksmi th 6.0). 

THE I racLLJOE: < . i > commp^imd 

LPL f 1 1 es can be saved with their own name on the parameter disk. These 
f i 1 es can refer to other named LPL f i 1 es on the parameter disk and can 
include parts of these fil es or ent ire named f 1 1 es within them. In this 
way you can use a technique used in another file without repeating the LPL 
statement & , si mpl y by refer ring to the name of the other file. For 
example, if a file called "BRQDBUND" e>;ists on the parameter disk, and it 
contains LPL statements which you wish to use in the current file, use the 
foil owl ng statement i n your LPL file: 

. I BRODBUND 

The " . I " must appear as the first characters on the line, and be foil owed 
by a space. All of the statements in the named file "BRODBUND" would be 
i nc 1 uded when the file you ^re enter ing was expanded by the te:ct editor 
dur 1 ng ei ther a syntax check or backup operat i on . You can save your file 
to the parameter disk ei ther before ex pan si on (to save disk space) or 
jf ter e>:pansi on . Incl uded fil es can , in turn, refer to additi onal 
included files. If you wi sh to incl ude part of a file, you can spec i f y 
the star ting and ending line numbers after the file name. For ex amp 1 e; 

.1 TESTFILE,4-1F 

The above ex amp 1 e woul d incl ude onl y 1 i ne numbers 4 through IF from the 
file named "TESTFILE". 

There is no limit to the number of .1 include statements which you can 
use, except that the total number of lines in the file cannot exceed FF 
(decimal 255) . 

Each line entered into the LPL file is given a line number (the line 
number appears to the left of the 1 i ne in "inverse" characters) . The 1 ine 
number is printed in hexadecimal to save space on the display, but the 
line numbers are not i mp or t ant , except when including te;;t from other LPL 
files with the .1 directive. An LPL line can be up to 38 characters long. 
The following is an e;; amp 1 e of an LPL 1 i ne: 

FIND D5 AA 96 

The above example is an LPL line which consists of a single LPL statement. 
You (- an enter several statements on a single line by separating them by 
coluns <:). For ex amp 1 e: 
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SLOT 6 z IN. DRIVE 1 ! OUT. DRIVE 2 

The spaces before and after each colon are not necessary, but Are included 
for easier readability. If a statement is too long for the current line, 
it can be continued onto the next line by coding a "-" as the last 
character on th« line. For exAOiplei 

DEPOSIT <DF) <F4> <DF) (D4) <FF) - 
05 AA 96 AA AA 

You may insert remarks or comments into your file at any time to help 
document what you are doing. An aster i sk ( t ) causes the restofthe 
statement to be ignored. Note that the comment is a statement, and that 
any statements following it on the line are evaluated. For e::ample: 

« SET SLOT NUMBER : SLOT 6 
SLOT 6 : * SET SLOT NUMBER 

Both the above lines are equivalent. Blank lines can be included anywhere 
for ease of readability and are ignored. 

LPL statements consist of "tokens" which can be thought of as words in a 
sentence. Tol^ens are separated by blanks. The first tok-o used in a 
statement determines the type of the statement. A token tan represent a 
variable name or parameter name, a constant, or a processiny routine name. 
Statements can be grouped into the following categories: 

comment or blank line 
statement label 
assignment statement 
processing 

Any statement may have a statement label preceding it. Statement labels 
are optional and are used for branching within the LPL file with the GOTO 
statement. A statement label begins with the keyword "LABEL", and i^ 
foil owed by a name. Label names can be of any 1 ength , and are any 
sequence of alphabetic or numeric characters or the period, with the first 
character being alphabetic. The following are examples using valid 
statement 1 abel s : 

LABEL READ. TRACK. AGAIN : 

&OTQ READ. TRACK. AGAIN 

LABEL A2. ERROR : PRT "LENGTH ERROR" 
GOTO A2. ERROR 

Several types of constants are used within LPL. They are described here, 
with e:<amples of each. 

Single byte constant (hex): 
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D5 
6 

00 
(FF) 
Single byte constants, when enclosed in parenthesis, indicate self-sync. 

Multiple byte constant (hex): 
(FF) D5 AA 96 
00 10 20 30 40 50 60 70 80 

Doubl e byte constant (hex ) ; 

1A70 

Doub 1 e byte constants usual 1 y represent addresses or 1 engths. 

Tract value constant (hex ) ; 

12.5 

1A.75 

11.0 

0. 

Track value constants cont ai n a decimal point. 

Single byte character constant: 

"X" 

' X' 

Note that either single or doubl e quotes CAn be used . 

Multiple byte char act er const ant : 

"DON'T FORGET TO COVER THE NOTCH." 

If a quote is to appear in the constant , use the other quote to delimit 

the string. 

Multiple byte constants can con si st of a mix oi hex and ASC II data: 
89 'GRD' BD 

Specialconstant: 

The "'^" represent s a "don* t care" value, when used in search patterns. 

Flay constants: 

YES 

NO 

ON 

OFF 

These constants are equivalent to O and FF, but are preferred because o-f 

their readability. 

Vari able names used within LPL usual ly have a specific use for each name. 
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although sume yetier al pur po^e namet have been provicletf fcjr the user. 
Se-'eraJ types of variable names Are provided within LFL . Thiey Are 
described here, with examples for each. 

Single byte variable: 

SLOT 

IN. DRIVE 

OUT. DRIVE 

Multiple byte pattern/string variable: 

GR. CHARS 

RATI 

SYNC. PAT 

Pat t«rn/str i ng variables Are variable length, and have a one byte length 

as the first byte of the variable. Although pattern/string variables have 

a variable ItTigth, eactt is allowed a maximum length of 15 (decimal). 

fiL'ltiple byte variable: 

NIP. Tr-Mtn 

RFC. TRANS 

INV.TAB 

The-'ie variables refer to multiple-byte AreA^ of memory of fi;.ed length, 

i,L.^h as 1 aot up tables. Because they Are fi^ed length, there is no length 

1 ^te pref I . .i-^sociated with ttie variable. 

If you tiave a need to refer to a byte within a multiple byte variable, you 
can code a plu^s sigri followed by the displacement into ttie table. For 
t-.. ainpl e: 
NIP. TRANS +2F 

Double byte pointer variable: 

START 

I \m 

Tfl .LFN 

ri IF SOR 

f rp.w 

r TR. X 
F T F . Y 
FTR. Z 
Double byte puiriter variables can also represent lengths. 

Tr ^c I \/Ar I db 1 e: 

trr,IN.TRF 

FND. TRK 

I NCR. TRK 

'3YNC. TRK 

Track variables can represent integral tract values, ur 1/4, 1/?, or T/4 

tracks. 

Fl aq wAr i abl e: 

SYNC 

COUNT 
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SHOW. ADDR 

Flag variables are single byte variables that contain a flag ai YES/NO, 
ON/OFF, or FF/0 and act as switches which can be set and tested. Values 
other than these may have unpredictable results. 

THE <=^SS rCBlNIMEIsn- STT^TEMEIMT 

The assignment statement is used to assign a value to a variable. The 
variable can be assigned the value o-f a constant or another variable. 

The variable to be assigned and the variable or constant to which it is 

assigned must be of the same type. For example, a pointer variable can 

only be assigned to another pointer variable or a two-byte value (3 or 4 

hex digits) . 

Some examples of valid assignment statements are: 

START CURSOR 

Set the variable START (start of track data) to CURSOR (current cursor 

1 Dcat 1 on ) . 

CURSOR 2040 

Sets the value of CURSOR to point to 2040. 

SLOT 6 

Sets the one-byte variable SLOT to the value 6. 

BF6IN.TRK 12.5 

Sets the track variable BEGIN. TRK to the track value 12.5. 

ClJR.TRr SYNC. TRK 

Sets the track variable CUR. TRK to the track variable SYNC. TRK. 

COUNT YES 

Sets the flag variable to the flag value YES. 

PflT4 D5 AA 96 

FAT4 PAT7 

Botfi of the above string variable assignments are valid. 

CR. CHARS 89 'GRD' 

Sets the string variable GR. CHARS to the 4-byte string consisting of ha;< 

89 (tontrol-I character) followed by the ASCII data 'GRD'. 

DF.HDR3 B4 : AF.HDR3 DD 

The'^e a^_isi cjninent statements set the third data field header byte to B4 

(rior^iully AD) and thf third address field header byte to DD (normally 96). 

Loct..iiiith 6.0 Page 63 User's Manual 



AF.TRLl.TEST IGNDRt.TRL 

AF.TRL2.TEST IGNORE. TRL 

DF.TRLl.TEST IGNDRE.TRL 

DF.TRL2.TEST IGNDRE.TRL 

These assignment statements patch RWTS to ignore the trailer nibbles of 

the address field and data -field. 

AF.TRLl.TEST NDRM.TRLl 
AF.TRL2.TEST NDRn.TRL2 
DF.TRLl.TEST NORM.TRLl 
DF.TRL2.TEST NORM. TRL2 
These statements patch RWTS bach to normal trailer nibble checking. 

AF.CSUIi.TEST IGNORE. CSUM 

DF.CSUM.TEST IGNORE. CSUM 

AF.CSUM.TEST NORM. AF. CSUM 

DF.CSUM.TEST NORM. DF. CSUM 

These are used to patch RWTS to ignore or to use the address field and 

data field checlsums. 

AF. CSUM. SEED 00 

DF. CSUM. SEED 00 

These statements set the checksum seed values for RWTS read address field 

and read data field. 

AF.HDRl D5 

AF.HDR2 AA 

AF.HDR3 9i 

AF.TRLl DE 

AF.TRL2 AA 

DF.HDRI 05 

DF.HDR2 AA 

DF.HDP3 AD 

DF.TRLl DE 

DF. TRL2 AA 

Th,:-^^e statements set the default header and trailer values for address 

fields and data fields which a^re used for reading. 

DF.HDRl.WRT D5 

DF.HDR2.WRT AA 

DF.HDR3.WRT AD 

DF.TRLl.WRT DE 

DF.TRL2.WRT AA 

DF. CSUM. SEED. WRT 00 

These statements set the header and trailer nibbles to be used when 

writing a data field. The last statement sets the seed to be used for the 

calculation of the checksum for writing the data field. 
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LPL processi ng rout i nes (re-f erred to as "algorithms" in earli er versi ons 
of Locksmith) are rout ines that the user can invoke on demand usi ng LPL. 
Some ai the routines are comple:; and are dri ven by many variabl es, whi 1 e 
others are simple and operate using only one or two variables. Some 
routines use parameters consisting of constants or pointers passed to them 
and some accept no parameters at all. The valid syntax of each processing 
routine is described in an addendum to this manual, but we will describe 
some of the processing routines here and gi ve some e;<ampl es of their use. 
The Parameter Diskette included with your Locksmith is an e;;cellent source 
of e:;amples for the use of LPL processing routines and variable names. 
You may also wish to refer to a "Oui c k Reference of LPL Names " in the 
addendum to this manual for a compl ete list of all variable names and 
processi ng rout i ne names. 



ABORT "DATA NOT FOUND" 

Abor t s the current oper ation and di spl ays the message on the screen, then 

returns to the main Locksmith menu. 

PAUSE "ENTER 1,2, OR 3:" 

After a k^ey is pressed, the value of the key is placed in the single-byte 

variable KEY. IN 

PRT "DISK MUST BE WRITE/ENABLED" 

Prints the message on the screen. If the last character of the message is 

a bl ank , the cursor remai ns on the same 1 i ne for addi t i on a I output . 

SHOW SLOT 

Prints the value of the variable name SLOT. If the flag variable 

SHOW.ADDR IS YES or ON, the address of the variable SLOT is also printed. 

GOTO READ. AGAIN 

Branches to the label READ. AGAIN elsewhere in the LPL program. 

FIND D5 AA 96 

Causes a search from the current CURSOR pointer until the END pointer, 

searching for the string D5 AA 96. 

FIND PAT4 

This is the same as the previous example, except that the search is for 
the contents of the string variable PAT4. If a processing routine accepts 
a string van able, it also accepts an explicitly coded string. 

ERROR 'Z' 

Tfii'^ iza^i'Si^s the character '5' to be placed in the current track of the 

status display area. 

PAT4 D4 DD FF 
PAT'^j D5 AA 96 
CHANGE PAT4 PAT5 

Thiiii processing routine rhanges all occurrences of the first string to the 
secund for the entire range of START to END. Note that the CHANGE 
statement and other statements that accept two strings as parameters do 
not accept multiple bytt? constants. For example, the following use of the 
CHANGE statement is invalid: 
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CHANGE D5 AA 96 PAT4 
CHANGE PAT4 D5 AA 96 
CHANGE D5 AA P4 TO D5 AA 96 

COPY 22 1 (invokes track procedure) 
FCOPY 22 (Fast Disk Backup copy) 

ERASE 

Th is causes the track to be erased on the output dr i ve. 

FORWARD TRf'.LEN 

BACK TRK.LEN 

These statements cause the CURSOR to be moved forward or backward by the 

length determined by the variable TRK.LEN. These routines can also be 

coded with a 2-byte constant . For e;< ampl e: 

FORWARD 024E 

BACK' 0042 

CODE AD CUR.TRK OA OA OA OA 60 

The CODE processing routine is provided -for the 6502 assembly language 
programmer. The parameters suppl i ed ans decoded , pi aced in a cant i guous 
area of memory, and given control with a JSR instruction. 

PRT '■ASCII TEXT TO PRINT" 

The "PRT" routine prints data on the display screen. If the last byte of 

the string is a blani, no new line is started. In this way, you can 

display te;;t with the val ue o-f a variable name. For e:< ampl e: 

PRT "TRACK INCREMENT IS " : SHOW INCR.TRK 

Some processing routines function slightly differently depending on 
whether in "ni bb 1 e- mode" or in "byte-mode". If the last read or write 
command was NREAD or NWRITE, then nibble-mode is in effect. If the last 
read or write command was SREAD, SWR I TE , TREAD or TWRITE, then byte-mode 
IS in ef f ec t . 

The routines which function differently depending on whether in nibble 
mode or byte mode are FIND, VER, and CHANGE. 

In nibble mode, a zero val ue in the pattern specifi ed acts as a "don't 
care" value. It can be coded as either "'^" or "0". 

In byte mode (used when readi ng or wr iting sectors), the zero val ue in a 
pattern is significant. 

For e:;ampl e: 

NREAD : FIND D5 00 96 

Th» *bovB «t«t»m»nt« parform a nibbl«-r»«d of the current track, and place 
the CURSOR on the first occurrence of a DS value, followed by an/ v*lu», 
followed by a 96 value. 

The statement s: 

TREAD : FIND DS 00 96 
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The above e;;ample per-forms a tract-read o-f the current tracts, and places 
the CURSOR on the -first occurrence of a D5, followed by a 00, followed by 
a 96. 

In byte-mode, "don't care" values in pattern search strings are not 
al lowed. 

The following processing routines accept either string variables or 

multiple byte constants: 

FIND 

VER 

REP 

DEPOSIT 

The nibble or byte mode can be changed manually by setting the flag 
variable BYTE. MODE to YES if byte mode is desired, or to NO if nibble mode 
i 5 desi red . 
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A track procedure is a sequence o-f LPL statements that are to be executed 
for each trad that is being copi ed . (One may con si der the ent i re LPL 
file as a disk procedure, because it is involved with processing the 
entire disk to be copied.) The trad procedure is defined with the 
BEGIN. PROC and END.PRQC statements. The track procedure is then later 
invoked for each track to be copi ed, by a processing routine whi ch invotes 
the tracV procedure. There is currently only one rout i ne whi ch invokes 
the current track procedure. The COPY processing routine (either 
nibble-copy or sector -copy) invokes the current track procedure. The 
"current " track procedure is the last one wh ich was defined. If no track 
procedure was defined in the LPL file, then the default Locksmith tracV: 
procedure is used. 

For exampl e: 

BEGIN. PROC 

. . . track procedure A 

END. PROC 

COPY a 2 
COPY 12 18 2 

BEGIN. PROC 

... track procedure B 

END.PRQC 

COPY 1 9 2 
COPY 13 19 2 

In the above e:;ample, the first two COPY processing routines will use 
treck procedure A, and the second two COPY routines will use track 
procedure B. 

The LPL statements within the track procedure can be used to process a 

track m one of two modes. Either in nibble-mode or sector-mode. 

Nibbl e-mode processing routines are NREAD, NWRITE, NVERIFY, which process 

a trad in the form of nibbles. Sec tor -mode process! ng routines are 

TREAD, TWRITE, TVERIFY, which process a track in the form of 16 separate 

sectors. 

The format of the COPY command is: 

COPY :begin.trk> <end.trk> <incr.trk> 

where <begin . tr h :^- is the starting tracf. , <rend,trl<> i« the anding tract, 
and ■ incr . tr k > is the track increment. These values are stored in th« 
variable names BEGIN. TRK, END.TRK, and INCR.TRK, respectively. 

If trad s are to be synchronized or nibble-count preservation is to be 
performed, set the variable names SYNC or COUNT to the value YES. The 
SYNC and COUNT keywords Are not specified on the COPY command, as in 
version 5.0 of Lod smith. 
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During execution ai the LPL program, some errors may be encountered which 
cannot be checked for during syntax check oi the LPL statements. 

H ^n error is encountered during execution oi LPL code, processing 
immediately stops and the -following message is displayed on the screen: 

LPL CODE ABORTED 

ERROR CODE ;:x 

where ";<:<" is one of the foil owing val ues: 

1 GOTO statement encountered wi thout finding the matching LABEL 
statement . 

02 FROC. BEGIN statement encountered while already within a track 
procedure. 

03 FROC. END statement encountered whi le already outside of a tract- 
procedure. 

04 COPY statement encountered within a track procedure. The COPY 
statement i nvokes a t rac k procedure and cannot occur wi thin one. 

05 USE. DEFAULT . FROC encountered whi le within a track procedure. 
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nxbbi_e: deczode: tabl-e: 



OOiAA 


AA 


20: BA 


AA 


40: AA 


EA 


60: BA 


EA 


80: EA 


AA 


A0:FA 


AA 


CO:EA 


EA 


EOl 


FA 


EA 


OliAA 


AS 


21:BA 


AB 


41:AA 


EB 


61:BA 


EB 


81:EA 


AB 


A1:FA 


AB 


Ct:EA 


EB 


Ell 


FA 


EB 


02>AB 


AA 


22: BB 


AA 


42: AB 


EA 


62: BB 


EA 


82:EB 


AA 


A2:FB 


AA 


C2:EB 


EA 


E2: 


FB 


EA 


03iAB 


AB 


23:BB 


AB 


43: AB 


EB 


63:BB 


EB 


83:EB 


AB 


A3:FB 


AB 


C3:EB 


EB 


E3 


FB 


EB 


04tAA 


AE 


24: BA 


AE 


44: AA 


EE 


64: BA 


EE 


a4:EA 


AF 


A4:FA 


AE 


C4:EA 


EE 


E4i 


FA 


EE 


OSlAA 


AF 


2SiBA 


AF 


45: AA 


EF 


65: BA 


EF 


BSiEA 


AF 


A5:FA 


AF 


C5:EA 


EF 


E5 


FA 


EF 


O61AB 


AE 


26:BB 


AE 


46: AB 


EE 


66: BB 


EE 


86: EB 


AE 


A6:FB 


AE 


C6:EB 


EE 


E6 


FB 


EE 


07iAB 


AF 


27: BB 


AF 


47:AB 


EF 


67:BB 


EF 


87: EB 


AF 


A7:FB 


AF 


C7:EB 


EF 


E7 


FB 


EF 


08: AE 


AA 


28: BE 


AA 


48: AE 


EA 


68: BE 


EA 


B8:EE 


AA 


A8:FE 


AA 


CSsEE 


EA 


Ea 


FE 


EA 


09SAE 


AB 


2V:BE 


AB 


49:AE 


EB 


69: BE 


EB 


89:EE 


AB 


A9:FE 


AB 


C9:EE 


EB 


E9 


FE 


EB 


OAsAF 


AA 


2A:BF 


AA 


4A:AF 


EA 


6A:BF 


EA 


8A:EF 


AA 


AA:FF 


AA 


CA:EF 


EA 


EA 


FF 


Efl 


OB:AF 


AB 


2B:BF 


AB 


4B:AF 


EB 


6B:BF 


EB 


8B:EF 


AB 


AB:FF 


AB 


CB:EF 


EB 


EB 


FF 


EB 


OClAE 


AE 


2C:BE 


AE 


4C:AE 


EE 


6C:BE 


EE 


8C:EE 


AE 


AC:FE 


AE 


CC:EE 


EE 


EC 


FE 


EE 


ODlAE 


AF 


2D: BE 


AF 


4D:AE 


EF 


6D1BE 


EF 


aD:EE 


AF 


AD:FE 


AF 


CD:EE 


EF 


EO 


FE 


EF 


OElAF 


AE 


2E:BF 


AE 


4E:AF 


EE 


6E:BF 


EE 


aE:EE 


AF 


AE:FF 


AE 


CE:EF 


EE 


EE 


FF 


EE 


OFlAF 


AF 


2F:BF 


AF 


4F:AF 


EF 


6F:BF 


EF 


8F:EF 


AF 


AF:FF 


AF 


CF:EF 


EF 


EF 


FF 


EF 


IOjAA 


BA 


30: BA 


BA 


S0:AA 


FA 


70: BA 


FA 


90: EA 


BA 


BO: FA 


BA 


DO:EA 


FA 


FO 


FA 


FA 


11: AA 


BB 


31:BA 


BB 


S1:AA 


FB 


71:BA 


FB 


91:EA 


BB 


B1:FA 


BB 


D1:EA 


FB 


Fl 


FA 


FB 


12!AB 


BA 


32: BB 


BA 


52:AB 


FA 


72:BB 


FA 


92: EB 


BA 


B2:FB 


BA 


02: EB 


FA 


F2 


FB 


FA 


13:AB 


BB 


33:BB 


BA 


53:AB 


FB 


73: BB 


FB 


93:EB 


BB 


B3:FB 


BB 


D3:EB 


FB 


F3 


FB 


FB 


14:AA 


BE 


34: BA 


BE 


54:AA 


FE 


74: BA 


FE 


94:EA 


BE 


B4:FA 


BE 


D4:EA 


FE 


F4 


FA 


FE 


IS: AA 


BF 


35: BA 


BF 


55: AA 


FF 


75: BA 


FF 


95: EA 


BF 


B5:FA 


BF 


05: EA 


FF 


F5 


FA 


FF 


1&:AB 


BE 


36: BB 


BE 


56: AB 


FE 


76: BB 


FE 


96:EB 


BE 


B6:FB 


BE 


06: EB 


FE 


F6 


FB 


FE 


17:AB 


BF 


37:BB 


BF 


57:AB 


FF 


77: BB 


FF 


97:EB 


BF 


B7:FB 


BF 


D7:EB 


FF 


F7 


FB 


FF 


ia>AE 


BA 


38: BE 


BA 


S8:AE 


FA 


78: BE 


FA 


98: EE 


BA 


Ba:FE 


BA 


08: EE 


FA 


FB 


FE 


Ffl 


19>AE 


BB 


39: BE 


BB 


59:AE 


FB 


79: BE 


FB 


99: EE 


BB 


B9:FE 


BB 


D9:EE 


FB 


F9 


FE 


FB 


1A:AF 


BA 


3A:BF 


BA 


5A:AF 


FA 


7A:BF 


FA 


9A:EF 


BA 


BA:FF 


BA 


DA:EF 


FA 


FA 


FF 


FA 


1B:AF 


BB 


3B:BF 


BB 


SB:AF 


FB 


7B:BF 


FB 


9B:EF 


BB 


BB:FF 


BB 


OB:EF 


FB 


FB 


FF 


FB 


IC:AE 


BE 


3C:BE 


BE 


5C:AE 


FE 


7C:BE 


FE 


9C:EE 


BE 


BC:FE 


BE 


DC:EE 


FE 


FC 


FE 


FE 


10:AE 


BF 


3D: BE 


BF 


SD:AE 


FF 


7D:BE 


FF 


9D:EE 


BF 


BD:FE 


BF 


DD:EE 


FF 


FO 


FE 


FF 


1E:AF 


BE 


3E:BF 


BE 


5E:AF 


FE 


7E:BF 


FE 


9E:EF 


BE 


BE:FF 


BE 


OE:EF 


FE 


FE 


FF 


FE 


1F:AF 


BF 


3F:BF 


BF 


5F:AF 


FF 


7F:BF 


FF 


9FiEF 


BF 


BF:FF 


BF 


DF:EF 


FF 


FF 


FF 


FF 



TFtf\CK IMLJMBEIFt DECODE: TABI_E: 

00:AA AA 01:AA AB 02:AB AA 03:AB AB 04:AA AE 05:AA AF 06:AB AE 

OB:AE AA 09: AE AB 0A:AF AA OBiAF AB 0C:AE AE OD:AE AF OE:AF AE 

IO:AA BA 11:AA BB 12:AB BA 13:AB BB 14:AA BE tS:AA BF I61AB BE 

18:AE BA 19:AE BB 1A:AF BA IBtAF BB 1C:AE BE 10:AE BF 1E:AF BE 
20: BA AA 21:BA AB 22: BB AA 23: BB AB 
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SEICTOFt iNlUMBEFt DECODE T#=»Bl_E 

NIBBLES VALUE NIBBLES VALUE 



AA AA 


00 


AE AA 


08 


AA AB 


01 


AE AB 


09 


AB AA 


02 


AF AA 


OA 


AB AB 


03 


AF AB 


OB 


AA AE 


04 


AE AE 


OC 


AA AF 


05 


AE AF 


OD 


AB AE 


06 


AF AE 


OE 


AB AF 


07 


AF AF 


OF 



The follawing translatw table i& usad for calculating data fi«ld 
check&ums. It is dascribed in th« chapter on th* disk editor describing 
the 'D" command. 



00: 


.96, 


01: 


97 


02: 


9A 


03: 


9B 


04 1 


;9D 


05 i 


i9E 


06 1 


9F 


07i 


A6 


OB: 


iA7 


09 1 


:AB 


OAi 


AC 


OB: 


AD 


OC: 


;AE 


OD: 


AF 


OEl 


B2 


OF: 


B3 


10: 


iB4 


11: 


iB5 


12: 


:B6 


13: 


:B7 


Ml 


iB9 


15: 


:BA 


16i 


:BB 


17i 


BC 


IBi 


:BD 


19: 


I BE 


lA: 


;BF 


IB: 


iCB 


ICl 


I CD 


ID: 


iCE 


IE: 


;CF 


IF: 


;D3 


20! 


!D6 


21i 


iD7 


22; 


:D9 


23: 


:DA 


24i 


:DB 


25: 


:DC 


26; 


I DO 


27; 


:DE 


28; 


:DF 


29: 


lES 


2A! 


lE6 


2B; 


!E7 


2Ci 


!E9 


2D! 


:EA 


2E! 


rEB 


2Fi 


lEC 


30; 


lED 


31: 


:EE 


32: 


;EF 


33: 


iF2 


34: 


;F3 


35: 


:F4 


36: 


;F5 


37: 


!F6 


38 1 


!F7 


39: 


lF9 


3A: 


!FA 


3B: 


!FB 


3Cl 


iFC 


3D: 


!FD 


3E: 


iFE 


3Fl 


iFF 
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F*MY€t I C^i- TO L-OI3 I O^L- TTR^IMQI-^-r I OM Trf^^OLEI 

Th« mvctor numberm contained in the addrams fislda o-f m 16-sactor 
-forniAttsd dimkett* appear in ascanding order (40 to •F) on successive 
sectors. These physical sector numbers are converted by the disk 
operating system to logical sector numbers, to allow -For faster read/write 
o-f multiple sectors. The following table shows the relationship between 
physical sector number and logical sector number. 

PHYSICAL LOGICAL 









1 


7 


2 


E 


3 


6 


4 


D 


5 


S 


6 


c 


7 


4 


B 


B 


9 


3 


A 


A 


B 


2 


C 


9 


D 


1 


E 


8 


F 


F 
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TR^CK l_«VOUTS <1.3 mrtd XA m»c=^c3r-> 



TYtmrm hav* bmmn tMo dlffar»nt track foraata In coaaon uaa tor tha Appla 
II. Ona of thaa racordad 13 aactora on aach of tha 33 tracka. Tha othar, 
by aaploylng a aora afflclant data packing algoritha and allghtly aodlflad 
hardMara, la capabla of racordlng 16 aactora par track. 

Both foraata Mra baaically tha aaaa, nith tha axcaptlon of tha mathod of 
packing tha data flald. In addition, tha addraaa flald haadar i« allghtly 
diffarant to allcm tha two diffarant foraata to ba Idantlflad aaally. 

Slnca tha 13 sactor format la no longar In common uaa. Ma Mill diacuaa tha 
16 aactor format, and Mill idantify Mhara tha tMO formata diffar. 

Tha track is racordad hI th 16 (or 13) aactora, aach conaistlng of an 
addraaa flald and a data flald. Tha addraaa fiald containa information 
about tha data fiald Mhich Immadiataly folIOMa it. Tha fialda ara 
aaparatad by gapa, Mhich contain 'avlf-aync' nibblaa. Thaaa aalf-aync 
nibblaa ara apacially racordad nibblaa Mhich cauaa tha diak controllar 
hardMara to aynchroniza, ao that tha fiald folloMing tha aalf-aync can ba 
r vad. 

Tha addraaa and data fialda aach contain a haadar. Information nibblaa, 
and a trailar. 

Tha addraaa fiald containa haadar nibblaa of OS AA 96 (or OS AA BS, if 13 
aactor), folloMad by 4 itama of information, ancodad in doubla-nibbl a 
format. Tmo conaacutiva nibblaa »rm uaad to rapraaant tha voluma numbar, 
track numbar, aactor numbar, and chackaum. Tha chackaum ia aimply an 
axcluaiva-or of tha othar 3 itama of information. A tabla la includad in 
thia manual to allOM you to convart thaaa doubl a-ni bbl aa to tha valuaa 
thay rapraaant. FollOMing thaaa 4 itama of Inforaation, i* tha addraaa 
fiald trailar, Mhich conaiata of D£ AA. 

Aftar a gap of aalf-aync nibblaa, tha data fiald appaara. Tha data fiald 
conaiata of a haadar, D3 AA AD, follOMad by 342 nibblaa (or 410, If 13 
aactor format) k^ich rapraaant tha actual aactor data. Thaaa nibblaa Mrm 
ancodad uaing a 6-bit tabla ahoMn in tha appandix aaction of thia manual 
tltlad -Data Fiald Nibbia Encoding". (If 13 aactor format, a S-bit tabla 
ia uaad.) Aftar tha data nibblaa, a aingla nibbia ia providad for 
chackaua, follOMad iamadlataly by tha data fiald trailar, DE AA. 

In aoma aarly protactlon achaaaa, tha haadar and trailar nlbblas in tha 
addraaa and data fialda Mara changad to aoma othar valua. (aaa "Hlatory 
of Lockaaith and Copy Protactlon* chaptar of thia manual) 
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Attention Apple //gs Users: 

The current version of Locksmith 6.0 (revision level Dl will work properly 
with any version of Apple // computer, including the Apple //gs. 
However, the Fast Disk Backup ( F" from main menu) recognizes only 64K 
of the 256K (or more) of the //gs memory. If you are going to be using 
your Locksmith on an Apple //gs, we suggest that you apply a patch which 
is supplied on the included library diskette. 

The patch, which is named "JPATCH FDB IIGS 256 , patches your Locksmith 
Fast Disk Backup to assume that it is running on an Apple //gs, and will 
use 256K of auxiliary memory to perform one-pass backup copies. 

Apply this patch only if you are using your Locksmith on an Apple //gs, as 
after this patch is applied. Fast Disk Backup will not work properly on 
machines other than an Apple //gs. And, of course, you should only patch 
a copy of your Locksmith diskette, keeping the original in a safe place. 

To patch your Locksmith diskette: 

1 . Boot your Locksmith disk. 

2. Press "T" to enter the text editor. 

3. Press "N", then "B" (backup/copy disk) 

4. Remove Locksmith disk and insert library disk, then press space bar. 

5. Press down-arrow key (or control-J) until "SPATCH FDB IIGS 256" is 
highlighted, then press return. 

6. Remove the library disk and insert the Locksmith disk, (make sure 
that the write-protect tab is removed) 

7. Press the space bar. 

8. Press return key twice. 

9. Press space bar. 

10. Press return key. "PATCH APPLIED SUCCESSFULLY' should appear. 

11. Remove Locksmith diskette, cover the write-protect notch. Your 
Locksmith disk is now updated. 

1 2. To use the updated version of Locksmith, you must reboot Locksmith. 

Note that when running Fast Disk Backup, the display incorrectly shows 
that 64K auimem is being used (28 tracks per pass). Actually, 256K will 
be used (for 35 tracks per pass - one pass copies.) 



Also included on the library disk are other $PATCH files, including one 
named "IPATCH TXT.ED DR2" which will set the default library disk drive 
to drive two for users with two drive systems. 
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